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:

bash
# 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).

Planning & Alignment #

SkillCommandPurpose
grill-me/grill-meConducts 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-docsInterrogates planning decisions while simultaneously building lasting codebase glossary terms and architectural decision records (ADRs).
shapeWireframe-first pass that outputs an ASCII layout, state list, content inventory, and question list before any UI code is written.

Code Quality & Simplicity #

SkillCommandPurpose
ponytail/ponytailForces 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-reviewCode review focused exclusively on over-engineering. Finds what to delete: reinvented stdlib, unneeded dependencies, speculative abstractions, dead flexibility.
ponytail-audit/ponytail-auditWhole-repo audit for over-engineering. Scans the entire codebase for bloat, unnecessary complexity, and opportunities to simplify.
ponytail-debt/ponytail-debtHarvests every ponytail: comment in the codebase into a debt ledger—tracking deliberate shortcuts so they do not rot into forgotten technical debt.
code-reviewReviews 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 #

SkillCommandPurpose
technical-writingAnti-fluff writing style guide: paragraph-first (no bullet-point walls), meaningful subtitles, peer-developer tone, prohibition of filler words ("crucial", "robust", "leverage").
professional-proofreaderFinal polish pass for grammar, punctuation, tone consistency, and voice preservation with structured modification logs.
editorial-qaFact-checking and editorial quality assurance: catches accuracy issues, inconsistencies, and unsupported claims across documentation.

UI Design & Craft #

SkillCommandPurpose
ui-craftAnti-slop rules for UI implementation. Required discovery phase before coding, guidance for layout, typography, color, motion, accessibility, and polish.
tokensAudits or establishes the project's 3-layer design token spine (primitives → semantics → components).
heuristicScored critique using Nielsen's 10 heuristics + 6 design laws. Outputs a machine-parseable scorecard with a 0-100 UsabilityScore.

Research & Investigation #

SkillCommandPurpose
researchInvestigates a question against high-trust primary sources and captures findings as a Markdown file in the repo.
diagnosing-bugsDiagnosis loop for hard bugs and performance regressions. Structured hypothesis-test-refine cycle until root cause is identified.

Automated Review Agents #

ToolPurpose
BugBotSpecialized, automated pull-request auditing agent for catching low-level code bugs and security regressions in diffs.
CodeQLGitHub's semantic code analysis engine. Queries code as structured data to find vulnerability patterns.
SemgrepLightweight 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:

plaintext
.agents/skills/your-skill-name/
└── SKILL.md

The SKILL.md file uses YAML frontmatter for metadata and Markdown body for instructions:

markdown
---
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:

HarnessSkill SupportLoading Mechanism
AntigravityNative.agents/skills/, ~/.agents/skills/, auto-discovery
Claude CodeNativeProject-level custom commands + CLAUDE.md references
CursorVia rules.cursor/rules/*.mdc with skill-like activation patterns
ClineNativeMCP-based tool loading + custom instructions
AiderConvention filesLoaded via /read command or convention arguments
PiExtensionsTypeScript extensions + skill markdown files