Skip to content

CLAUDE.md

Latest commit

 

History

History
56 lines (41 loc) · 2.64 KB

CLAUDE.md

File metadata and controls

56 lines (41 loc) · 2.64 KB

agent-skill-library

This is the agent-skill-library 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)
hooks/        → Session lifecycle hooks
.claude/commands/ → Slash commands (/discover, /spec, /plan, /jira-sync, /build, /test, /review, /code-simplify, /ship, /quick, /jira-spec, /jira-plan, /jira-ship, /pm-spec, /pm-epic, /pm-breakdown, /pm-sync)
references/   → Supplementary checklists (testing, performance, security, accessibility, project tooling discovery)
docs/         → Setup guides for different tools

Skills by Phase

Discover: brownfield-discovery Define: spec-driven-development, jira-spec-driven-development Plan: planning-and-task-breakdown, jira-planning-and-task-breakdown
Sync Jira (after plan): jira-board-sync SysPM (PM workflow): syspm, pm-spec-and-prd, pm-epic-decomposition, pm-jira-sync, pm-status-and-reporting Build: incremental-implementation, context-engineering, frontend-ui-engineering, api-and-interface-design, mobile-app-engineering
Verify: browser-testing-with-devtools, debugging-and-error-recovery Review: code-review-and-quality, code-simplification, security-and-hardening, performance-optimization Ship: documentation-and-adrs, shipping-and-launch, jira-shipping-and-launch Ad-hoc: quick-task-execution

Conventions

  • Every skill lives in skills/<name>/SKILL.md
  • YAML frontmatter with name and description fields
  • 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

All skills are invoked via slash commands with the sys: prefix (e.g., /discover → sys:brownfield-discovery).

  • npm test — Not applicable (this is a documentation project)
  • Validate: Check that all SKILL.md files have valid YAML frontmatter with name and description

Plugin Configuration

  • Plugin name: sys (changed from agent-skills)
  • Command prefix: sys: for all skill invocations
  • Marketplace install: /plugin install sys@systango-agent-skills

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