4.2 KiB
4.2 KiB
Skill Index
This file is the canonical registry for the instruction suite. Read this index after AGENTS.md and the deployment profile, then open only the hub and skill files needed for the current task.
Skill Contract
Every skill file follows the same structure:
PurposeWhen to useInputs to gatherHow to workOutput expectationsQuality checklistHandoff notes
Loading Guidance
- If DEPLOYMENT-PROFILE.md is filled in, treat it as the default preference layer before applying generic skill guidance.
- Start narrow: one hub plus the smallest set of specialized skills that covers the task.
- Typical task size: two to four skills.
- Larger, cross-functional tasks may need four to six skills, but only when each one adds a distinct concern.
- Prefer high-leverage skills that shape implementation quality over collecting adjacent but redundant guidance.
- When in doubt, prioritize repository exploration, implementation/debugging, testing, and one domain-specific skill.
Category Hubs
Specialized Skills
Software Development
- Architecture and System Design
- Feature Implementation
- Refactoring
- Code Review
- Test Strategy
- API and Backend Work
- Database Migrations and Data Evolution
- Dependency Lifecycle Management
- Performance Optimization
- Security Review and Hardening
- Observability and Operability
- Maintenance and Technical Debt Planning
- Frontend UI Implementation
- Repository Exploration
- Release and Change Summary
Debugging
Documentation
UI/UX
Marketing
Brainstorming
Quick Routing Hints
- If the task changes code, start with the software development hub.
- If the task starts from a defect, regression, failing test, or unclear breakage, add debugging skills.
- If the task changes how people use, adopt, or understand the product, add documentation and possibly UX or marketing skills.
- If the task asks for options, concepts, or strategic directions before execution, use brainstorming skills.
- If the task affects long-term system health, look for architecture, security, performance, observability, dependency, or maintenance skills before loading more tactical ones.