Recommended Skills Library
ON THIS PAGE
Skills are reusable playbooks loaded into an agent's working context when a specific task requires domain expertise. Think of them as expert checklists that encode institutional knowledge: the patterns a senior engineer would follow, the edge cases a QA lead would catch, the style conventions a tech writer would enforce. They keep the main context window lightweight by loading on-demand, and they ensure repeatable quality regardless of which team member (or agent) executes the task.
The Skills Ecosystem in 2026 #
The primary registry for discovering and installing skills is skills.sh, which hosts thousands of community and vendor-published skills with security assessments. Installation is a single command:
# Install a skill globally (available across all projects)
npx skills add <author>/<repo>@<skill-name> -g
# Install a skill locally (scoped to current project)
npx skills add <author>/<repo>@<skill-name>
Skills are stored as directories containing a SKILL.md file (Markdown with YAML frontmatter) and optional supporting resources (scripts, examples, references). Most modern harnesses—Antigravity, Claude Code, Cursor, Cline—support loading skills from .agents/skills/ (project-scoped) or ~/.agents/skills/ (global).
Recommended Skills by Category #
Planning & Alignment #
| Skill | Command | Purpose |
|---|---|---|
| grill-me | /grill-me | Conducts exhaustive alignment interviews to clarify specs, edge cases, and business intent before the agent writes code. Prevents the most expensive failure mode: building the wrong thing. |
| grill-with-docs | — | Interrogates planning decisions while simultaneously building lasting codebase glossary terms and architectural decision records (ADRs). |
| shape | — | Wireframe-first pass that outputs an ASCII layout, state list, content inventory, and question list before any UI code is written. |
Code Quality & Simplicity #
| Skill | Command | Purpose |
|---|---|---|
| ponytail | /ponytail | Forces the laziest solution that actually works. Channels a senior dev who has seen everything: question whether the task needs to exist, reach for stdlib before custom code, one line before fifty. |
| ponytail-review | /ponytail-review | Code review focused exclusively on over-engineering. Finds what to delete: reinvented stdlib, unneeded dependencies, speculative abstractions, dead flexibility. |
| ponytail-audit | /ponytail-audit | Whole-repo audit for over-engineering. Scans the entire codebase for bloat, unnecessary complexity, and opportunities to simplify. |
| ponytail-debt | /ponytail-debt | Harvests every ponytail: comment in the codebase into a debt ledger—tracking deliberate shortcuts so they do not rot into forgotten technical debt. |
| code-review | — | Reviews changes since a fixed point (commit, branch, tag) along two axes: Standards (does the code follow this repo's conventions?) and Spec (does the code match the originating issue?). |
Writing & Documentation #
| Skill | Command | Purpose |
|---|---|---|
| technical-writing | — | Anti-fluff writing style guide: paragraph-first (no bullet-point walls), meaningful subtitles, peer-developer tone, prohibition of filler words ("crucial", "robust", "leverage"). |
| professional-proofreader | — | Final polish pass for grammar, punctuation, tone consistency, and voice preservation with structured modification logs. |
| editorial-qa | — | Fact-checking and editorial quality assurance: catches accuracy issues, inconsistencies, and unsupported claims across documentation. |
UI Design & Craft #
| Skill | Command | Purpose |
|---|---|---|
| ui-craft | — | Anti-slop rules for UI implementation. Required discovery phase before coding, guidance for layout, typography, color, motion, accessibility, and polish. |
| tokens | — | Audits or establishes the project's 3-layer design token spine (primitives → semantics → components). |
| heuristic | — | Scored critique using Nielsen's 10 heuristics + 6 design laws. Outputs a machine-parseable scorecard with a 0-100 UsabilityScore. |
Research & Investigation #
| Skill | Command | Purpose |
|---|---|---|
| research | — | Investigates a question against high-trust primary sources and captures findings as a Markdown file in the repo. |
| diagnosing-bugs | — | Diagnosis loop for hard bugs and performance regressions. Structured hypothesis-test-refine cycle until root cause is identified. |
Automated Review Agents #
| Tool | Purpose |
|---|---|
| BugBot | Specialized, automated pull-request auditing agent for catching low-level code bugs and security regressions in diffs. |
| CodeQL | GitHub's semantic code analysis engine. Queries code as structured data to find vulnerability patterns. |
| Semgrep | Lightweight static analysis with custom rule authoring for project-specific anti-patterns. |
Writing Custom Skills #
When your team develops domain-specific expertise that no existing skill covers—your proprietary deployment pipeline, your industry-specific compliance checks, your internal API conventions—encode it as a custom skill rather than relying on individual engineers to remember and enforce the pattern manually.
A minimal custom skill requires:
.agents/skills/your-skill-name/
└── SKILL.md
The SKILL.md file uses YAML frontmatter for metadata and Markdown body for instructions:
---
name: your-skill-name
description: One-line description of what this skill does and when to trigger it.
---
# Your Skill Name
## When to Use
Describe the trigger conditions.
## Instructions
Step-by-step process the agent should follow.
## Constraints
Hard rules the agent must not violate.
## Output Format
What the agent should produce when done.
For more complex skills, add supporting directories: scripts/ for helper scripts, examples/ for reference implementations, references/ for additional documentation, and resources/ for templates or assets.
Cross-Harness Compatibility #
The SKILL.md convention originated in Claude Code and has been adopted by most major harnesses, though with varying levels of native support:
| Harness | Skill Support | Loading Mechanism |
|---|---|---|
| Antigravity | Native | .agents/skills/, ~/.agents/skills/, auto-discovery |
| Claude Code | Native | Project-level custom commands + CLAUDE.md references |
| Cursor | Via rules | .cursor/rules/*.mdc with skill-like activation patterns |
| Cline | Native | MCP-based tool loading + custom instructions |
| Aider | Convention files | Loaded via /read command or convention arguments |
| Pi | Extensions | TypeScript extensions + skill markdown files |