health-analyze-skill
Analysis phase for /assist:health-check command - scores each component
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Health-Check Analysis Phase
The second phase of the /assist:health-check workflow. Performs detailed health analysis and scoring of each component.
Purpose
Analyze each component's quality, completeness, and suitability, producing a health score.
Scoring Dimensions
Structure Score (25%)
| Factor | Points |
|---|---|
| File exists in correct location | 5 |
| Valid YAML frontmatter | 5 |
| All required fields present | 10 |
| Optional fields present | 5 |
Content Score (25%)
| Factor | Points |
|---|---|
| Non-trivial content length | 10 |
| Clear formatting | 5 |
| Proper sections | 5 |
| No placeholder text | 5 |
Reference Score (25%)
| Factor | Points |
|---|---|
| All references valid | 10 |
| Appropriate tool selection | 10 |
| No orphaned components | 5 |
Suitability Score (25%)
| Factor | Points |
|---|---|
| Component type matches purpose | 10 |
| Appropriate for Claude Code plugin | 10 |
| Follows best practices | 5 |
Component-Specific Criteria
Skills
- Clear trigger phrases (not generic)
- Focused on single purpose
- Adequate context provided
- Examples where helpful
Agents
- Appropriate tool selection
- Clear system prompt
- Defined scope
- Error handling guidance
Commands
- Clear usage instructions
- Helpful examples
- Appropriate tool restrictions
- Good documentation
Grade Scale
| Score | Grade | Meaning |
|---|---|---|
| 90-100 | A | Excellent - Production ready |
| 80-89 | B | Good - Minor improvements possible |
| 70-79 | C | Acceptable - Should address issues |
| 60-69 | D | Needs work - Multiple issues |
| < 60 | F | Critical - Requires significant fixes |
Output Format (Per Component)
COMPONENT: skills/router-skill
TYPE: skill
SCORES:
Structure: 22/25
Content: 23/25
References: 25/25
Suitability: 20/25
TOTAL: 90/100 (A)
ISSUES:
- None
RECOMMENDATIONS:
- Consider adding more trigger phrase variations
Transition Evidence
To proceed to aggregate phase, provide:
-
analyzed_count: Number of components analyzed -
scores: Map of component path to score -
grade_distribution: Count of A/B/C/D/F grades
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!