Skip to main content

Skills

On-demand instruction bundles for specific tasks. Skills are loaded by agents when needed and provide step-by-step workflows for common development activities.

Skill Reference

SkillDescription
a11y-auditComprehensive WCAG AA audit with automated scanning, manual verification, and fix implementation.
agent-customizeConfigure per-agent customization via .customize.yaml files.
api-specGenerate and validate OpenAPI specifications from codebase. Covers endpoint design, schema validation, and documentation generation.
architecture-reviewEvaluate architectural decisions, compare options with pros/cons, and produce ADRs following the project template.
bug-fixDiagnose root cause, implement minimal fix, and write a regression test that fails before the fix. TDD/test-first workflow option.
ci-pipelineDesign and optimize CI/CD pipelines. Covers stage design, test parallelization, artifact management, and pipeline performance.
command-customizeConfigure per-command customization via .customize.yaml files.
customizeCreate and manage customization files for any hatch3r artifact type (agents, commands, rules, skills). Supports model overrides, scope overrides, enable/disable control, and project-specific instructions.
context-healthMonitor conversation context health and detect degradation during long sessions.
cost-trackingTrack token usage and estimated costs across agent workflows.
dep-auditAudit npm dependencies for CVEs and freshness, research migration paths, upgrade one at a time with testing.
featureEnd-to-end feature implementation as a vertical slice covering data model, domain logic, API, and UI. TDD/test-first workflow option.
gh-agentic-workflowsSet up GitHub Agentic Workflows for continuous AI-powered triage, testing, and documentation automation.
incident-responseStructured triage, mitigation, root cause analysis, and post-mortem for production incidents with follow-up issues.
issue-workflow8-step development workflow for GitHub issues: parse, load skill, read specs, plan, implement, test, PR, address review.
logical-refactorChange business logic or data flows without adding features, with explicit invariant tracking and verification.
migrationPlan and execute migrations for databases, frameworks, and dependencies. Covers breaking change analysis, phased rollout, and rollback procedures.
perf-auditProfile and optimize against defined performance budgets with before/after measurements for every change.
pr-creationCreate pull requests following project conventions -- branch naming, PR template, self-review checklist, and size guidelines.
qa-validationE2E validation workflow producing structured pass/fail reports with evidence and ship/hold recommendations.
recipeCreate and manage composable workflow recipes.
refactorInternal code quality improvement without changing external behavior, with behavioral preservation tests.
releaseCut a release with semantic versioning, changelog generation, pre-release/RC support, git tagging, and deploy verification.
rule-customizeConfigure per-rule customization via .customize.yaml files.
skill-customizeConfigure per-skill customization via .customize.yaml files.
visual-refactorUI/UX changes matching design mockups with WCAG AA accessibility and responsiveness verification.

Canonical Location

Skills live in .agents/skills/hatch3r-{id}/SKILL.md. Each skill is a self-contained instruction document that agents read when performing a specific type of work.

Customization

Override skill behavior per-project using .hatch3r/skills/{id}.customize.yaml. See Customization.