pedronauck-skills

Pedro Nauck's Skills

A curated collection of 87 agent skills for Claude Code and compatible AI coding assistants — 40 original (⭐️), 34 hand-picked (💎), and 13 marketing & business (📣). 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 three top-level buckets:

• skills/mine/ — 40 original skills authored in this repository (⭐️)
• skills/curated/ — 34 hand-picked skills, including locally authored skills (💎)
• skills/marketing/ — 13 marketing, business, and writing 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 through the current harness's native subagent facility for multi-area research — each slice writes one seven-section analysis file, and the parent synthesizes a summary
• 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
• ddd-master — Assess DDD fit and model language, bounded contexts, and aggregates using scoped references and existing domain evidence
• deep-review — Review branch diffs, working trees, and PRs with automated preparation, staged rule discovery, compact per-job assessments, targeted repairs, complete defect/polish coverage, and optional PR publication
• deslop — Remove AI-generated code slop from the branch diff — unnecessary comments, abnormal defensive checks, any casts, deep nesting — before claiming a task complete or opening a PR
• drizzle-safe-migrations — Production-safe Drizzle migration workflows for schema changes
• git-rebase — Git rebase operations and merge conflict resolution with clean history
• glassmorphism — Glass and Apple Liquid Glass interfaces on the web at reference quality: a material anatomy (thin light fill, one locked light direction expressed as rim + inset highlight + sheen + tinted shadow, optional grain), three ink modes chosen by backdrop luminance (white on light tint, white on smoked tint, dark ink on white frost) with measured contrast, a solid-first glass.css token system with reduced-transparency / forced-colors / print fallbacks, geometry-derived SVG displacement refraction for small controls (Chromium-only, with the filter-region and chromatic-pass traps), a runnable material lab with seven backdrops and a live contrast estimate, a 22-item reference board, rendering-cost budgets and triage, and conditional SwiftUI / visionOS / Fluent / Expo routes
• golang-master — Go 1.21–1.26 engineering doctrine for any Go codebase — a ten-rule floor (error wrapping, goroutine ownership, context-first APIs, race-clean tests) plus branch-routed references: errors (sentinel vs typed, %w chains, single-handling rule, panic policy), concurrency (channel/mutex/atomic and WaitGroup/errgroup decision tables, errgroup.SetLimit pools, spawn checklist), context (cancellation discipline, WithoutCancel detachment, value hygiene), safety (nil interface trap, append aliasing, numeric truncation, defer-in-loop), interfaces & generics (consumer-side contracts, cmp.Ordered constraints), naming & style (anti-stutter, functional options, no init()), assertion-framework-free testing (table-driven, synctest, goleak, b.Loop()), pprof-first performance methodology, version-by-version modernization tables, and module layout. Supersedes the curated golang-pro
• herdr-orchestration — Orchestrate Claude and Codex worker TUIs from a controller agent — one worker per named herdr tab, driven over the herdr socket CLI; supports plan-first delegation (Claude Code plan mode, Codex Plan mode) and native agent-status waits; controller owns assignment, state, conflict control, integration, and retirement (verified workers' tabs are closed, never left piled up); workers launch as interactive TUIs via herdr agent start
• insta-master — Plan, create, distribute, and monetize Instagram content by combining two complementary methodologies (pt-BR): Hyeser (tactical creator, 421k — Reels, virality, engagement, faceless monetization) and Rafael Kiso (mLabs founder — algorithm-as-graph, per-surface retention, internal search/SEO/AEO, consumer journey, social-media-as-a-business), distilled from 8 deep-research slices over 344 transcripts — the retention + social-signals distribution engine with per-surface thresholds (Feed 10s / Explore 11s / Reels 15s) and a diagnosis funnel, the COCA×journey content matrix (Growth / Objection / Connection / Authority), Reels craft ("it's the start, not the 3 seconds", 33% retention rule, hook→development→loop structure, lo-fi CapCut editing, A/B test reels), modern discovery (caption-as-semantic-field with the Question→Answer template, hashtag-as-SEO timeline, AEO to appear in ChatGPT/IA), profile foundations (bio-promise, subniche, @name, 0→1000 plan, converting bio link), Stories & cadence (3-5 story blocks, the frequency band over a magic number, best-time myth), creator monetization & selling (sell-without-looking-like-an-ad 80/20, 4-step DM social selling, affiliate / clips / faceless-IA / IG Shop / infoproduct), social-media-as-a-business (value/ROI pricing, 4-pillar method, media kit, UGC × influencer × brandlover), a publication checklist, plus read-only retencao-check.py + post-check.py helpers
• kb-yt-channel — Turn a YouTube channel into a Karpathy KB topic — resolves recent or full uploads, scaffolds yt-channels topics, ingests transcripts via kb ingest youtube (captions / auto / STT), and validates plus indexes the result
• no-workarounds — Enforce root-cause fixes over workarounds, hacks, and symptom patches
• qa-execution — Run scoped dogfooding through public product interfaces, record findings in living QA docs, and repair within authorization; assess PR or release readiness when included in the request
• qa-report — Plan real-user QA as living repo docs: owns the canonical docs/qa/ tree, merge-safe by construction — content-addressed ids and one file per scenario/bug/charter, so parallel branches never contend (enum-disciplined scenario tracker materialized into a gitignored state.csv view, global bug registry with the five-tier user-impact rubric, project personas, journey flowcharts, session charters, coverage taxonomy, automation backlog). Maps every user-visible change as a Mermaid journey flow before deriving scenarios (flows-before-matrix), plans persona×journey×tour session charters by cadence tier (smoke/targeted/full/sanity), and enforces "every journey walked by a persona this cycle" completeness — sessions, not test-case accumulation.
• react — React 19 under the React Compiler — the Rules of React as a build-time contract (purity, immutability, refs, globals, static components) with each rule mapped to its eslint-plugin-react-hooks v7 lint rule, a memoization decision table for when useMemo/useCallback/memo still earn their place, the full bail-out catalogue (three hard syntax errors plus the silent Todo skips) with "use no memo" bisection and DevTools/healthcheck detection, compiler setup per bundler and incremental adoption, effects (anti-pattern catalogue, useEffectEvent, useSyncExternalStore), component and composition patterns, React 19 TypeScript migration (ref as prop, React.JSX, useRef arity) with codemods, state placement plus interior-mutability libraries, React 19/19.2 APIs (use(), Actions, useOptimistic, <Activity>, metadata, cacheSignal), and Vitest/RTL v16 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.
• spec-peer-review — Optional cross-LLM peer review of a spec (TechSpec/design doc/RFC/PRD) via Compozy — an independent model writes one scoped findings file (blockers/nits + READY/BLOCKED/NEEDS_REWORK) for user-directed incorporation. Project-agnostic with configurable --ide/--model/--reasoning runtime, six tech-agnostic quality markers, and auto-discovered project rules
• storybook-stories — Create, update, or refactor Storybook stories following project patterns
• tailwindcss — Tailwind CSS v4 patterns, design tokens, and tailwind-variants
• tanstack — TanStack Query, Router, and Form patterns for React — query keys, caching, mutations, prefetching, SSR/offline, file-based routes, search params, loaders, and Form validation
• tech-logos — Install official tech brand logos from the Elements registry via shadcn