addyosmani--agent-skills
Federico Bartoli
05472ac53a
Follow-up suggested in #223 review: folds in the useful half of #61 (the observability checklist) as this skill's quick-reference companion, mirroring the security-and-hardening / security-checklist pairing. Aligned with the merged skill's framing: on-call questions first, RED/USE metrics, cardinality rules, symptom-based alerting with the page/ticket two-severity rule, telemetry verification, and a pre-launch gate. Linked from the skill's Verification section and registered in the README references table and CLAUDE.md.
2.1 KiB
2.1 KiB
agent-skills
This is the agent-skills project — a collection of production-grade engineering skills for AI coding agents.
Project Structure
skills/ → Core skills (SKILL.md per directory)
agents/ → Reusable agent personas (code-reviewer, test-engineer, security-auditor, web-performance-auditor)
hooks/ → Session lifecycle hooks
.claude/commands/ → Slash commands (/spec, /plan, /build, /test, /review, /code-simplify, /ship; plus /webperf specialist audit)
references/ → Supplementary checklists (testing, performance, security, accessibility, observability)
docs/ → Setup guides for different tools
Skills by Phase
Define: interview-me, idea-refine, spec-driven-development Plan: planning-and-task-breakdown Build: incremental-implementation, test-driven-development, context-engineering, source-driven-development, doubt-driven-development, frontend-ui-engineering, api-and-interface-design Verify: browser-testing-with-devtools, debugging-and-error-recovery Review: code-review-and-quality, code-simplification, security-and-hardening, performance-optimization Ship: git-workflow-and-versioning, ci-cd-and-automation, deprecation-and-migration, documentation-and-adrs, observability-and-instrumentation, shipping-and-launch
Conventions
- Every skill lives in
skills/<name>/SKILL.md - YAML frontmatter with
nameanddescriptionfields - Description starts with what the skill does (third person), followed by trigger conditions ("Use when...")
- Every skill has: Overview, When to Use, Process, Common Rationalizations, Red Flags, Verification
- References are in
references/, not inside skill directories - Supporting files only created when content exceeds 100 lines
Commands
npm test— Not applicable (this is a documentation project)- Validate: Check that all SKILL.md files have valid YAML frontmatter with name and description
Boundaries
- Always: Follow the skill-anatomy.md format for new skills
- Never: Add skills that are vague advice instead of actionable processes
- Never: Duplicate content between skills — reference other skills instead