Reference Files
Detailed scoring guidance:
- scoring-rubric.md - 1-5 criteria per dimension with specific indicators
- quality-dimensions.md - What each dimension measures and why it matters
- examples.md - Sample assessments showing scoring in action
- report-template.md - Standardized output format for quality reports
Purpose
This skill provides objective quality assessment of Claude Code skills using a standardized 6-dimension scoring system. Unlike cc-lint (structural validation) or cc-check (functional testing), this skill focuses on quality measurement with numerical scores.
Quality Dimensions (Weighted)
| Dimension | Weight | Focus | | -------------------- | ------ | ----------------------------------------------- | | Effectiveness | 28% | Does it achieve its stated purpose? | | Clarity | 22% | Is documentation clear and understandable? | | Best Practices | 17% | Progressive disclosure, context economy, safety | | Documentation | 15% | Completeness and organization of docs | | Verification | 10% | Can you confirm the output is correct? | | Trigger Coverage | 8% | Will users discover and invoke it? |
Quality Tiers
Based on weighted average score:
| Range | Tier | Meaning | | ------- | -------------------- | ------------------------------------------- | | 4.5-5.0 | Production Ready | Excellent quality, no improvements needed | | 3.5-4.4 | Good | Solid quality, minor improvements possible | | 2.5-3.4 | Needs Work | Functional but requires attention | | 1.5-2.4 | Poor | Significant issues, major rework needed | | 1.0-1.4 | Unusable | Fundamental problems, likely non-functional |
Evaluation Process
- Locate the skill - Find SKILL.md and any reference files
- Read all content - Examine main file and supporting documentation
- Score each dimension - Apply rubric criteria (see scoring-rubric.md)
- Calculate weighted average - Compute overall score
- Determine quality tier - Map score to tier
- Generate report - Include dimension scores and evidence (see report-template.md)
Scoring Guidelines
For each dimension:
- Review the dimension criteria in quality-dimensions.md
- Apply the 1-5 rubric from scoring-rubric.md
- Document specific evidence supporting the score
- Note any borderline cases or scoring rationale
Scoring principles:
- Be specific - Cite exact text, files, or patterns as evidence
- Be fair - Consider the skill's intended scope and purpose
- Be consistent - Apply the same standards across all skills
- Document reasoning - Explain why each score was given
Tools Used
This skill uses read-only tools for analysis:
- Read - Examine SKILL.md and reference files
- Glob - Find all files in the skill directory
- Grep - Search for patterns and keywords
- Bash - Run
wcand other read-only commands
No files are modified during evaluation.
Usage Examples
Evaluate a specific skill:
Rate the quality of the cc-lint skill
Compare multiple skills:
Score cc-lint and cc-check, which is higher quality?
Quick quality check:
What's the quality tier for vc-ship?
Output
Reports include:
- Individual dimension scores with evidence
- Weighted average score
- Quality tier classification
- Dimension-specific observations
- Optional comparison to other skills
See report-template.md for the complete output format.
Relationship to Other Tools
| Tool | Purpose |
| ------------------- | --------------------------------- |
| cc-lint | Structural validation (pass/fail) |
| cc-check | Functional testing (works/broken) |
| skill-quality | Quality scoring (1-5 scale) |
| skill-improve | Improvement recommendations |
Run cc-lint first for structural validation, then skill-quality for subjective quality scoring.