pantheon-ai/skill-quality-auditor
Audit and improve skill collections with an 8-dimension scoring framework, duplication detection, remediation planning, and CI quality gates; use when evaluating skill quality, generating remediation plans, validating report format, or enforcing repository-wide skill artifact conventions.
Does it follow best practices?
Evaluation — 93%
↑ 1.33xAgent success when using this tile
Validation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that excels across all dimensions. It provides comprehensive specific capabilities, includes extensive natural trigger terms users would actually say, explicitly addresses both what and when, and carves out a distinct niche around skill file auditing. The description is thorough without being padded with fluff.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: '8-dimension scoring framework', 'duplication detection', 'remediation planning', 'CI quality gates', 'baseline comparison', 'trend analysis', 'artifact validation', 'consistency checking'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what (audit/improve skills with scoring framework, duplication detection, etc.) AND when (explicit 'Use when...' clause with multiple trigger scenarios and natural user phrases). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural user phrases: 'check my skills', 'review skill files', 'skill audit', 'improve my SKILL.md files', 'find duplicate skills', 'validate skill format', 'quality check my skills'. These are terms users would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | Highly specific niche focused on SKILL.md files and skill collections with domain-specific terms like 'tessl compliance', 'A-grade optimization', '8-dimension scoring framework'. Unlikely to conflict with general code review or documentation skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality skill that exemplifies its own principles. It provides concrete, executable guidance with clear workflows, proper validation checkpoints, and excellent progressive disclosure through a well-organized reference map. The anti-patterns section with WHY/BAD/GOOD structure adds significant value for error prevention.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, assuming Claude's competence throughout. No unnecessary explanations of basic concepts; every section serves a clear purpose with minimal verbosity. | 3 / 3 |
Actionability | Provides concrete, executable shell commands throughout (evaluate.sh, audit-skills.sh, check-consistency.sh, validate-skill-artifacts.sh). Commands are copy-paste ready with clear parameters and expected outputs. | 3 / 3 |
Workflow Clarity | Clear 6-step workflow (Inventory → Evaluate → Validate → Generate → Plan → Re-evaluate) with explicit validation checkpoints. Self-audit requirement and artifact validation before audits create proper feedback loops. | 3 / 3 |
Progressive Disclosure | Excellent navigation hub architecture with well-organized Reference Map categorized by priority (CRITICAL, HIGH, Supporting). Clear one-level-deep references to detailed documentation. SKILL.md stays focused as an overview. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Install with Tessl CLI
npx tessl i pantheon-ai/skill-quality-auditorReviewed
Table of Contents