Overview

Validates SKILL.md files for schema, quality, safety, portability, and scoring compliance, producing a deterministic validation report. It helps prevent flawed skill updates by surfacing actionable fixes.

How This Skill Works

It executes phase checks from references/phase-checks.md, generates a structured report via references/report-contract.md, and applies a deterministic score from references/scoring.md. Findings are classified into critical, warning, and enhancement buckets with remediation guidance.

When to Use It

• Use this skill when validating any skills/<name>/SKILL.md artifact.
• Use this skill before accepting skill updates.
• Do not use this skill to generate new skills.
• Run validation during code review or CI before merging changes.
• Apply the validation to ensure consistency with the approved reporting contract.

Quick Start

1. Step 1: Provide Target skill folder path, SKILL.md path, and any strictness settings.
2. Step 2: Run the validation workflow to execute phase checks, generate a report, and compute scores.
3. Step 3: Review the PASS/WARN/FAIL status and apply the suggested remediation.

Best Practices

• Provide the target skill folder and SKILL.md path as inputs.
• Specify any validation strictness expectations to guide checks.
• Rely on phase checks, report contracts, and scoring models as baseline.
• Keep findings deterministic and concise; avoid non-deterministic language.
• Produce actionable remediation guidance for blocking and non-blocking issues.

Example Use Cases

• CI validation of a new skills/awesome/SKILL.md before merge.
• Gating a skill update by running validation and failing on critical findings.
• Reviewing a validation report to implement remediation steps.
• Validating on a scheduled job before release.
• Auditing multiple skills to ensure consistency across artifacts.

Frequently Asked Questions