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)

code

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