Validate Skill
Purpose
Validate SKILL.md files with structured checks and produce consistent validation reports based on a deterministic scoring rubric.
When To Use
- Use this skill when validating any
skills/<name>/SKILL.mdartifact. - Use this skill before accepting skill updates.
- Do not use this skill to generate new skills.
How to Invoke
Load or attach this file's contents into your AI session to activate the workflow (paste, upload, or reference with #file:skills/validate-skill/SKILL.md in VS Code Copilot Chat). In Claude Projects, add it to project knowledge. See Invoking Skills in the README for full platform guidance.
Required Inputs
- Target skill folder path.
- Target
SKILL.mdpath. - Validation strictness expectations (if any).
Workflow
- Run validation phases from
references/phase-checks.md. - Generate report using
references/report-contract.md. - Apply deterministic scoring from
references/scoring.md. - Classify findings into critical/warning/enhancement buckets.
- Produce implementation-ready remediation guidance.
Output Expectations
- Structured markdown validation report.
- PASS/WARN/FAIL status and compliance score.
- Actionable fixes for blocking and non-blocking issues.
Resources
- Phase checks:
references/phase-checks.md - Report contract:
references/report-contract.md - Scoring model:
references/scoring.md - Skill template:
../../templates/skill_template/SKILL.md
Constraints And Safety
- Keep the scoring rubric deterministic; findings should be concise and repeatable.
- Preserve provider neutrality.
- Do not modify validated source files automatically.