Custom Skills

These are the repo-owned skills in ./skills/. Detail pages live under /skills/catalog/custom/<name>/. See Skill Catalog for external skills.

Quick Install

Install this repository catalog

Use the copy button or scroll horizontally inside the command area.

Copy

npx skills add github:wyattowalsh/agents --all -y -g --agent antigravity --agent claude-code --agent codex --agent crush --agent cursor --agent gemini-cli --agent github-copilot --agent grok --agent opencode

Install a focused starter skill

Copy

npx skills add github:wyattowalsh/agents --skill honest-review -y -g --agent antigravity --agent claude-code --agent codex --agent crush --agent cursor --agent gemini-cli --agent github-copilot --agent grok --agent opencode

How to use this page

Every card here corresponds to one tracked skills/<name>/SKILL.md file.

57 Custom Skills53 User-Invocable4 Convention Skills

All User-invocable Convention

Skill Lanes

Review & QA Code review, docs QA, test strategy, performance, or security scanning.

Build & Design Use these when you are creating frontends, APIs, data systems, infra, or MCP servers.

Strategy & Research Fuzzy problems, real trade-offs, or deeper investigation first.

Workflow & Utility Coordinate work, simplify code, git flow, releases, or local file tasks.

User-Invocable Skills (53)

Manual invocation Call these when you want a specialist on demand. They appear in the autocomplete menu.

add-badges Detect stack and generate shields.io README badges with icons, colors, live endpoints. Use when adding or updating badges.

agent-runtime-governance Audit runtime controls for tool permissions, approvals, memory, telemetry, evals, rollout, and containment. Use when reviewing tool-bearing agent systems.

api-designer Contract-first API design for REST, GraphQL, gRPC. Design, spec, review, version, compat, sdk. Use for API architecture and OpenAPI specs.

changelog-writer Generate changelogs, release notes, and migration guides from git history. Parse conventional commits. Use for releases.

chrome-devtools Use when debugging web pages with Chrome DevTools MCP: navigation, snapshots, screenshots, console issues, network requests, traces, or extensions.

chrome-devtools-a11y-debugging Use when auditing web accessibility through Chrome DevTools MCP: semantic HTML, ARIA labels, focus order, keyboard navigation, tap targets, contrast, and…

chrome-devtools-cli Use when auditing, writing, or running bounded shell commands that drive Chrome DevTools through the `chrome-devtools` CLI.

chrome-devtools-debug-optimize-lcp Use when auditing or optimizing Largest Contentful Paint with Chrome DevTools MCP: traces, element discovery, waterfalls, render blocking, and fix verification.

chrome-devtools-memory-leak-debugging Use when auditing JavaScript, browser, or Node.js memory leaks with Chrome DevTools MCP heap snapshots, repeated interactions, memlab, and retainer traces.

chrome-devtools-troubleshooting Use when auditing Chrome DevTools MCP setup failures: initialization, connection, page listing, navigation, missing tools, or wrong Chrome profile.

data-pipeline-architect Analyzes and designs batch and streaming data pipelines with contracts, lineage, reliability, and cost controls. Use for ingestion and transformation systems.

data-wizard Analyze data and guide ML: EDA, model selection, feature engineering, stats, visualization, MLOps. Use for data work.

database-architect Design schemas, plan migrations, and optimize queries. Six modes from modeling to evolution. Use for database architecture.

devops-engineer Design, optimize, and debug CI/CD pipelines. GitHub Actions and GitLab CI patterns. Use for pipeline work.

docling-graph Use when designing/reviewing Docling Graph knowledge-graph workflows: templates, contracts, CLI/API configs, inspect reports, exports, traces.

docs-steward Maintain docs across Starlight, Docusaurus, MkDocs. Sync, health checks, migrations, ADRs, runbooks, README, and AGENTS.md. Use when docs change.

draw-thing Generate local AI images and short media with Draw Things CLI on macOS.

email-whiz Gmail copilot via MCP. Triage, inbox-zero, filters, analytics, labels, cleanup. Use when managing email or automating Gmail.

event-driven-architect Design event-driven systems: contracts, topics, consumers, retries, idempotency, and sagas. Use for asynchronous workflows. NOT for CRUD APIs or ETL pipelines.

external-skill-auditor Audit third-party Agent Skills before install or repo promotion.

files-buddy Use when safely auditing, organizing, deduplicating, renaming, archiving, offloading, or reclaiming storage on macOS file systems and cloud-drive folders.

frontend-designer Build and audit React, Tailwind, shadcn/ui interfaces. Scaffold, create components/pages, theme, refactor, verify rendered UI. Use when building UI.

git-workflow Git operations: conventional commits, PR descriptions, branch strategy, conflict resolution, code archaeology, bisect. Use for git workflow tasks.

harness-master Audit harness configs, discover gaps, usage signals, apply approved fixes. Use when tuning Claude, Codex, Copilot, Cursor, Gemini, Grok, OpenCode, or Cherry.

honest-review Review code with confidence-scored evidence. Session, scoped, PR, or full audit; optional approved fix pass. Use when reviewing changes or quality.

host-panel Facilitate research-grounded panels in roundtable, Oxford, and Socratic formats. Use when exploring contested topics from multiple angles.

i18n-localization Plan and review localization changes across app, docs, and web surfaces.

incident-response-engineer Operational incident response for triage, containment, communications, recovery, and postmortems. Use when coordinating outages or service degradation.

infrastructure-coder Infrastructure-as-Code: Terraform, Kubernetes, Docker. Generate, review, cost-compare, security-scan. Use for IaC work.

learn Capture corrections and patterns as reusable knowledge. Routes to the right instruction file. Use when patterns repeat 3+ times or to save insights.

mcp-creator Build MCP servers with FastMCP v3. Research, scaffold, implement, test, deploy. Use when creating MCP servers or integrating APIs via MCP.

namer Name anything: projects, products, companies, packages.

nerdbot Use when creating, repairing, querying, auditing, or migrating Obsidian-native git KBs with raw/wiki layers. NOT for docs sites or generic notes.

new-project Initialize projects with safe, preference-driven scaffolds, docs, AI instructions, quality gates, GitHub setup, and design baselines.

observability-advisor Design and review logs, metrics, traces, SLOs, and alerting for reliable systems. Use for telemetry strategy and coverage gaps.

opencode-ensemble Use when coordinating OpenCode Ensemble teams, delegating independent coding work, reviewing teammate output, or running staged parallel waves.

openspec-workflow Use when planning, applying, validating, or archiving OpenSpec changes in this repo, or when downstream AI tools need OpenSpec JSON status/instructions.

orchestrator Review and orchestrate parallel execution via subagent waves, teams, and pipelines. Use when 2+ independent actions need coordination.

performance-profiler Performance analysis: complexity estimation, profiler output parsing, caching design, regression risk. Use for optimization guidance.

prompt-engineer Prompt engineering. Craft, analyze, harden, convert, design tool prompts, and build PromptOps/eval plans. Use for system, agent, tool, RAG prompts.

reasoning-router Classify problems and route to optimal thinking MCP (11 available). Monitor confidence, re-route on stall. Use for complex reasoning.

release-pipeline-architect Release workflow architecture for versioning, artifact promotion, rollout safety, and rollback design. Use for release pipelines.

research Deep multi-source research with confidence scoring. Auto-classifies complexity. Use for technical investigation, fact-checking.

schema-evolution-planner Plan zero-downtime schema changes across code, data backfills, and cutovers. Use for expand-contract database changes. NOT for fresh schema design or DBA ops.

security-scanner Proactive security assessment with SAST, secrets detection, dependency scanning, and compliance checks. Use for pre-deployment audit.

shell-scripter Shell script generation, review, and dialect conversion. Makefile and justfile generation. ShellCheck rules. Use for shell work.

simplify Simplify working code without changing behavior. Analyze, apply, or explain clarity fixes. Use when recent code feels complex.

skill-creator Create, improve, and audit AI agent skills. 14 structural patterns, deterministic scoring. Use when building or reviewing skills.

skill-router Route tasks to local skills. Use when choosing skills, recovering omitted skills after context warnings, or preparing a small skill context packet.

tech-debt-analyzer Systematic tech debt inventory with complexity analysis, dead code detection, and remediation planning. Track debt over time.

test-architect Test strategy, coverage analysis, edge case identification, flaky test diagnosis. Use when designing test suites.

things-manager Use when reviewing/managing Things 3 via SupaThings MCP: tasks, projects, headings, tags, deadlines, triage, capture, cleanup, and GTD.

wargame Strategic decision analysis and wargaming. Auto-classifies complexity for analysis or simulation. Use for decisions under uncertainty.

Convention Skills (4)

Auto-invoked The agent loads these automatically when repo context matches. They stay out of the / menu.

agent-conventions Agent definition conventions. Validate frontmatter, update indexes. Use when creating or modifying agents. NOT for skills, MCP servers, or CLAUDE.md.

javascript-conventions Configure and validate JS/TS tooling conventions. Enforce pnpm, TypeScript, ESLint, and Prettier defaults. Use when working on JS/TS files or package.json.

python-conventions Enforce Python tooling conventions for uv, ty, Ruff, pytest, and pyproject.toml. Use when working on .py files or Python project config.

shell-conventions Apply and review shell tooling conventions. Enforce portable bash and sh practices, quoting, env usage, and Make or just patterns. Use when editing shell files.

---

Installing Individual Skills

You can also install specific skills rather than the full collection:

# Install a single skill globally
npx skills add github:wyattowalsh/agents --skill honest-review -y -g --agent antigravity --agent claude-code --agent codex --agent crush --agent cursor --agent gemini-cli --agent github-copilot --agent grok --agent opencode

# Install multiple specific skills
npx skills add github:wyattowalsh/agents --skill honest-review --skill wargame -y -g --agent antigravity --agent claude-code --agent codex --agent crush --agent cursor --agent gemini-cli --agent github-copilot --agent grok --agent opencode

# Install to a specific agent only
npx skills add github:wyattowalsh/agents --skill orchestrator -y -g --agent claude-code

Creating your own skills

Want to build a custom skill? Use the skill-creator to scaffold, develop, audit, and package skills following proven structural patterns. Or run wagents new skill my-skill from the CLI.