Pedro Nauck's Skills

A curated collection of 122 agent skills for Claude Code and compatible AI coding assistants — 27 original (⭐️), 31 hand-picked (💎), 18 marketing & business (📣), plus 46 community skills. Each skill provides domain-specific knowledge, best practices, and guided workflows that enhance an agent's ability to perform specialized tasks.

Installation

Quick install (recommended)

Install this repository into your agent skills directory with the skills CLI:

npx skills add https://github.com/pedronauck/skills

Install a single bucket

Use the owner/repo/<subpath> shorthand to install only one bucket:

# Only the original skills
npx skills add pedronauck/skills/skills/mine

# Only the curated skills
npx skills add pedronauck/skills/skills/curated

You can also pin a specific skill with --skill:

npx skills add pedronauck/skills/skills/mine --skill react

Manual install

Copy or symlink the skills you need into your Claude Code configuration:

# Copy a single skill
cp -r skills/mine/react ~/.claude/skills/react

# Or symlink an entire bucket
ln -s $(pwd)/skills/mine ~/.claude/skills/mine

Skills are organized into four top-level buckets:

• skills/mine/ — 27 original skills authored in this repository (⭐️)
• skills/curated/ — 31 hand-picked community skills (💎)
• skills/marketing/ — 18 marketing, business, and writing skills (📣)
• skills/community/ — 46 broader community skills

Usage

Skills are automatically picked up by Claude Code when placed in the ~/.claude/skills/ directory. The agent matches tasks to relevant skills based on the description field in each SKILL.md frontmatter.

What are Skills?

Skills are structured instruction sets that give AI agents deep expertise in specific domains. Each skill lives in its own directory under skills/ and contains a SKILL.md file with metadata, procedures, and reference material. Skills follow the agentskills.io specification.

Skill Catalog

⭐️ = original skill authored in this repository  ·  💎 = hand-picked community skill  ·  📣 = marketing & business skill

Mine ⭐️

Original skills authored in this repository.

• agent-exploration — Dispatch scoped-write explorer subagents in parallel for codebase/topic research — each writes one analysis file to a seven-section schema, and the parent synthesizes a summary
• agent-output-audit — Independent audit of AI-implemented work / Compozy task slugs / AI-authored PRs. Runs the independent-evaluator protocol on implementer transcripts, scans test diffs for RF-1..RF-6 red flags (skipped tests, weakened assertions, mocks hiding integration, snapshot drift), reconciles task_NN.md frontmatter status: against evidence, runs the canonical CI gate with flaky-test triage, and emits a Quality Gates verdict. Integrates with cy-codex-loop slugs at .compozy/tasks/<slug>/.
• app-renderer-systems — Domain feature systems organized under a systems/ directory
• architectural-analysis — Deep architectural audit for dead code, duplication, anti-patterns, and code smells
• bubbletea — Build terminal UIs with Go and Bubbletea -- Elm architecture, Lipgloss styling, dual-pane layouts, and reusable components
• council — Run decisions through 5 independent advisors, anonymous peer review, and a chairman synthesis (Karpathy-style LLM Council)
• drizzle-safe-migrations — Production-safe Drizzle migration workflows for schema changes
• fix-coderabbit-review — End-to-end remediation workflow for PR review feedback
• git-rebase — Git rebase operations and merge conflict resolution with clean history
• no-workarounds — Enforce root-cause fixes over workarounds, hacks, and symptom patches
• outside-to-issue — Transform outside-of-diff review files into formatted issue files for a PR
• qa-execution — Execute QA the way a real user would: assign personas, run journey-driven sessions through agent-browser, execute time-boxed exploratory charters bound to one test tour, probe user edge cases (refresh-during-submit, multi-tab, autofill, slow network, session-expiry), and run the Cross-Functional Requirement pass (usability, accessibility, perceived performance, compatibility, recoverability, production parity).
• qa-report — Plan real-user QA: define personas, map user journeys, write time-boxed exploratory charters with test tours, generate persona/journey/CFR test cases, build journey-driven regression suites, validate Figma fidelity, and file bug reports keyed by user impact (Blocks-Completion / Data-Loss / Trust-Damage / Friction / Cosmetic).
• react — Component architecture, hooks, state management, TypeScript integration, and testing
• refactoring-analysis — Identify refactoring opportunities using Martin Fowler's code smells catalog with prioritized reports
• rust-best-practices — Unified Rust guidelines covering ownership, error handling, async/Tokio, traits, testing, performance, clippy, and documentation
• ship-pr — End-of-feature ritual: explore impact across docs/site/README, generate release notes (via pr-release when present, else inline from git log), assemble a complete PR description (with QA artifacts when detected), commit per the repo's commitlint, open the PR via gh, and optionally launch a CodeRabbit review-watch loop. Optional integrations (pr-release, skeeper, compozy, QA artifacts) auto-detect and skip cleanly when absent.
• skill-best-practices — Author professional-grade agent skills following the agentskills.io spec
• skill-load-tips — Refactor existing SKILL.md files so the agent actually loads bundled references — Required Reading Router, hard STOP directives, gist tripwires, and one-level reference depth
• storybook-stories — Create, update, or refactor Storybook stories following project patterns
• tailwindcss — Tailwind CSS v4 patterns, design tokens, and tailwind-variants
• tanstack — Comprehensive TanStack ecosystem guide — Query, DB, Form, Router, and Start
• tech-logos — Install official tech brand logos from the Elements registry via shadcn
• testing-boss — Comprehensive testing doctrine — Iron Laws, 12 positive patterns, 25 anti-patterns across five families, 7 mandatory gates for agents writing tests, flaky-test taxonomy with quarantine workflow, contract / property / mutation testing, and an LLM/agent eval primer (oracle ladder, LLM-as-judge calibration, agent trajectory vs outcome)
• to-prompt — Transform code, issues, or context into a detailed prompt for another LLM
• tweetsmash-api — TweetSmash REST API for fetching bookmarks, managing labels, filtering, and pagination
• typescript-advanced — Advanced type system -- generics, conditional types, mapped types, template literals
• ui-craft — Anti-AI-slop guardrails for UI/UX work — usability heuristics, accessibility floors, design-system discipline, 14 named slop patterns with severity tags, tunable design dials (VISUAL_VARIANCE/MOTION_INTENSITY/INFORMATION_DENSITY), scene-driven decisions, Product vs Brand registers, anti-defaults blocklist, 7 named UI archetypes, plus performance / motion / dark-mode reference packs and executable contrast + token-drift scripts

Curated 💎

Hand-picked community skills maintained in this repository.

• agent-browser — Automate browser interactions for testing, form filling, and data extraction
• agent-md-refactor — Refactor bloated AGENTS.md/CLAUDE.md files into organized, linked documentation
• architecture-diagram — Professional dark-themed system architecture diagrams as standalone HTML/SVG files
• autoresearch — Autonomously optimize any skill by running evals, mutating prompts, and keeping improvements
• brainstorming — Explore intent, requirements, and design through collaborative dialogue
• context7 — Retrieve up-to-date technical documentation, API references, and code examples for any library via Context7 CLI
• documentation-writer — Diátaxis-guided technical writing across tutorials, how-to guides, reference, and explanation quadrants
• effect-ts — Effect-TS code including setup, data modeling, error handling, and Context.Tag
• exa-web-search-free — Free AI-powered web, code, and company search via Exa MCP
• extreme-software-optimization — Profile-driven performance optimization with behavior proofs, opportunity scoring, and isomorphism guarantees
• firecrawl — Web scraping, search, crawling, and browser automation via the Firecrawl CLI
• game-changing-features — Find 10x product opportunities and high-leverage improvements
• golang-pro — Concurrent Go patterns, microservices with gRPC/REST, pprof optimization, generics, and idiomatic error handling
• hono — Hono framework development with documentation search and API reference
• impeccable — Production-grade frontend design and iteration — bold or quiet redesigns, live UI iteration, visual hierarchy, accessibility, motion, and design-token discipline backed by real working code
• lesson-learned — Extract software engineering lessons from git history and recent code changes
• mastra — Mastra framework for building AI agents and workflows
• next-best-practices — Next.js best practices -- file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, and optimization
• qmd — Search markdown knowledge bases, notes, and documentation using QMD
• ratatui-tui — Terminal UIs with ratatui v0.30.0+ -- Elm Architecture, StatefulWidget, async events
• sentry-cli — Sentry CLI for interacting with Sentry from the command line
• shadcn — Building UI components with shadcn/ui, Radix UI primitives, and design tokens
• systematic-debugging — Root-cause investigation before proposing fixes for bugs or test failures
• tui-design — Universal TUI design patterns -- layouts, color schemes, keyboard navigation, dashboards, and accessibility
• vercel-composition-patterns — React composition patterns for refactoring boolean prop proliferation
• vercel-react-best-practices — React/Next.js performance optimization from Vercel Engineering
• verification-before-completion — Run verification commands and confirm output before claiming success
• vitest — Fast unit testing with Vite -- Jest-compatible API, mocking, coverage, and fixtures
• xstate — XState v5 state machines, actors, @xstate/store, and TanStack Query integration
• zod — Zod schema validation for type safety, parsing, and error handling
• zustand — Zustand state management patterns, store organization, and best practices

Marketing 📣

Marketing, sales, business, and writing skills.

• alex-hormozi-pitch — Create irresistible offers using Hormozi's $100M Offers methodology
• brand-storytelling — Craft compelling brand narratives and positioning
• content-research-writer — Writing partner for research, outlining, drafting, and refining content
• copywriting — Conversion copywriting for marketing pages, CTAs, and headlines
• fundraising — Plan and run early-stage fundraising with pitch narrative, investor pipeline, and outreach
• google-ads — Query, audit, and optimize Google Ads campaigns
• hormozi-ad-factory — Generate 150-750+ ad variations using Hormozi's combinatorial Hook x Meat x CTA framework
• humanizer — Remove signs of AI-generated writing from text
• pitch-deck — Generate professional PowerPoint pitch decks for startups
• pitch-deck-visuals — Investor pitch deck visuals with slide-by-slide framework and design rules
• pitch-gen — Generate startup pitch deck content with AI
• pptx-creator — Create professional PowerPoint presentations from outlines or data
• professional-communication — Technical communication for emails, team messaging, and meeting agendas
• promo-video — Create promotional videos using Remotion with AI voiceover and background music
• sales-methodology-implementer — Implement proven sales methodologies (MEDDIC, BANT, Sandler, Challenger, SPIN)
• startup-validator — Comprehensive startup idea validation and market analysis
• viz — Four visualization modes in one skill -- Excalidraw diagrams, Swiss Pulse PNG infographics, inline Visualizer widgets, and published HeyGenverse apps
• writing-clearly-and-concisely — Strunk's timeless rules for clearer, stronger, more professional prose

Community

Broader community skills.

• a11y-testing — Automated accessibility testing with axe-core, Playwright, and jest-axe
• adversarial-review — Spawn opposing AI model reviewers to adversarially challenge work
• ai-sdk — Vercel AI SDK for building AI-powered features
• argocd-expert — ArgoCD GitOps deployment, sync strategies, and production operations
• better-auth-best-practices — Better Auth TypeScript authentication framework integration
• better-auth-organization-best-practices — Multi-tenant organizations, RBAC, teams, members, and invitations with Better Auth's organization plugin
• building-components — Accessible, composable UI components with design tokens and documentation
• centrifugo — Centrifugo real-time messaging -- WebSocket PUB/SUB, channels, JWT auth, scaling
• cloudflare — Cloudflare platform -- Workers, Pages, storage, AI, networking, and security
• crafting-effective-readmes — Templates and guidance for writing README files matched to audience and project
• creating-spec — Comprehensive technical specs for SDK gaps, features, or system centralization
• design-spec-extraction — Extract production-ready JSON design specs from visual inputs using a 7-pass architecture
• devops-engineer — Dockerfiles, CI/CD pipelines, Kubernetes manifests, and Terraform/Pulumi templates
• drizzle-orm — Drizzle ORM best practices -- schemas, queries, mutations, transactions, migrations
• drizzle-postgres — PostgreSQL and Drizzle ORM best practices for type-safe database apps
• electron-builder — Electron packaging, code signing, auto-updates, and release workflows
• electron-dev — Electron development with Electron Vite and Builder -- main/renderer processes, IPC
• electron-release — Electron production builds, notarization, auto-updates, and releases
• elysia — Type-safe APIs with Elysia including routing, validation, plugins, and error handling
• es-toolkit — Modern utility library as a lodash replacement -- array, object, string operations
• evolution-api — Evolution API for WhatsApp messaging, instance management, and chatbot orchestration
• executing-plans — Execute implementation plans in batches with review checkpoints
• find-rules — Discover project rules, coding standards, and architectural guidelines
• find-skills — Discover and install agent skills from the open agent skills ecosystem
• fixing-motion-performance — Diagnose and fix animation performance issues in UI code
• helm-chart-scaffolding — Design, organize, and manage Helm charts for Kubernetes applications
• hetzner-server — Create and manage Hetzner Cloud servers via the hcloud CLI
• inngest — Serverless background jobs, event-driven workflows, and durable execution
• k8s-security-policies — Kubernetes security policies -- NetworkPolicy, PodSecurityPolicy, and RBAC
• kubernetes-specialist — Deploy and manage Kubernetes workloads -- manifests, Helm, RBAC, networking, GitOps
• mermaid-diagrams — Software diagrams using Mermaid syntax -- class, sequence, flowcharts, ERD, C4
• motion — React animations with Motion (formerly Framer Motion) -- gestures, scroll effects, spring physics
• motion-react — Full Motion for React guide including SVG, exit animations, and layout transitions
• obsidian-bases — Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries
• obsidian-cli — Interact with Obsidian vaults via CLI -- read, create, search, manage notes, and develop plugins
• obsidian-markdown — Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and tags
• pal — Pal MCP toolkit for code analysis, debugging, planning, refactoring, and tracing
• perplexity — Web search and research using Perplexity AI
• remotion-best-practices — Best practices for Remotion video creation in React
• requirements-clarity — Clarify ambiguous requirements through focused dialogue before implementation
• ship-learn-next — Transform learning content into actionable implementation plans
• sourcebot — Search external libraries and frameworks using Sourcebot MCP
• tauri-v2 — Tauri v2 cross-platform apps with Rust backend, IPC, permissions, and builds
• terraform-style-guide — Terraform HCL following HashiCorp's official style conventions
• workflow — Durable, resumable workflows using Vercel's Workflow DevKit
• wrangler — Cloudflare Workers CLI for deploying and managing Workers, KV, R2, D1, and more

Structure

Each skill follows a consistent directory layout:

skills/
  mine/<skill-name>/       # Original skills authored here (⭐️)
  curated/<skill-name>/    # Hand-picked community skills (💎)
  marketing/<skill-name>/  # Marketing, business, and writing skills (📣)
  community/<skill-name>/  # Broader community skills

skills/<bucket>/<skill-name>/
  SKILL.md              # Main skill definition (required)
  references/           # Deep-dive reference material
  examples/             # Usage examples and patterns
  templates/            # Code templates and scaffolds
  scripts/              # Automation scripts and validators
  checklists/           # Step-by-step verification checklists

Contributing

To add a new skill:

1. Create a directory under the appropriate bucket with a lowercase, hyphenated name:
   • skills/mine/ — original work authored here
   • skills/curated/ — hand-picked, high-quality community skills you maintain
   • skills/marketing/ — marketing, sales, business, or writing skills
   • skills/community/ — broader community skills
2. Add a SKILL.md with proper frontmatter (name and description fields)
3. Include reference material, examples, and templates as needed
4. Follow the conventions documented in skills/mine/skill-best-practices/SKILL.md

License

See repository root for license information.