| name | description |
|---|---|
bd-skill-reviewing |
Framework for reviewing and improving agent skills for quality, effectiveness, and compliance with the agent-skills standard. Use when auditing existing skills, providing feedback on skill PRs, improving skill descriptions, or troubleshooting underperforming skills. |
This skill provides a systematic framework for evaluating and improving agent skills.
Evaluate skills against four dimensions:
- Correctness: Follows specification requirements
- Clarity: Instructions are unambiguous and actionable
- Effectiveness: Triggers appropriately and guides well
- Maintainability: Well-organized and easy to update
- Validate Structure: Check directory and file organization
- Evaluate Frontmatter: Verify name and description compliance
- Assess Content: Review clarity, completeness, progressive disclosure
- Check References: Verify organization and linking
- Test Effectiveness: Confirm triggers and guidance work
For detailed checklist with specific checks per category, see references/quality-checklist.md.
For anti-patterns to identify during review (with detection methods and fixes), see references/anti-patterns.md.
For patterns to fix common issues (with before/after examples), see references/improvement-patterns.md.
For review feedback templates and severity guidelines, see references/feedback-template.md.
- Rubber-stamping: Approving without thorough review
- Style-only focus: Missing structural or effectiveness issues
- No actionable feedback: Identifying problems without suggesting fixes
- Inconsistent severity: Misclassifying critical issues as minor