Agent Skill
2/7/2026

health-analyze-skill

Analysis phase for /assist:health-check command - scores each component

C
chkim
0GitHub Stars
2Views
npx skills add chkim-su/forge3

SKILL.md

Namehealth-analyze-skill
DescriptionAnalysis phase for /assist:health-check command - scores each component

name: health-analyze-skill description: Analysis phase for /assist:health-check command - scores each component triggers:

  • health-check analyze phase
  • component health scoring
  • quality analysis

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%)

FactorPoints
File exists in correct location5
Valid YAML frontmatter5
All required fields present10
Optional fields present5

Content Score (25%)

FactorPoints
Non-trivial content length10
Clear formatting5
Proper sections5
No placeholder text5

Reference Score (25%)

FactorPoints
All references valid10
Appropriate tool selection10
No orphaned components5

Suitability Score (25%)

FactorPoints
Component type matches purpose10
Appropriate for Claude Code plugin10
Follows best practices5

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

ScoreGradeMeaning
90-100AExcellent - Production ready
80-89BGood - Minor improvements possible
70-79CAcceptable - Should address issues
60-69DNeeds work - Multiple issues
< 60FCritical - 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
Skills Info
Original Name:health-analyze-skillAuthor:chkim