skill:check

Audit SKILL.md files for Progressive Disclosure compliance and generate PASS/WARN/FAIL reports.

Updated May 31, 2025
One-click install
npx skills add https://github.com/dEitY719/dotfiles --skill skill-check-deity719
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill:check
Source: https://github.com/dEitY719/dotfiles/tree/main/claude/skills/skill-check
Command: npx skills add https://github.com/dEitY719/dotfiles --skill skill-check-deity719

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audit and validate Progressive Disclosure compliance for SKILL.md files by ensuring concise content under 100 lines and the proper use of references/.

Core Features & Use Cases

  • Line-count validation to keep SKILL.md under 100 lines.
  • Structure checks to ensure details live in references/ rather than the main file, with a standardized PASS/WARN/FAIL output.
  • Guidance for maintainers on how to fix issues and restructure content for clarity.

Quick Start

Run an audit against your SKILL.md to produce a structured PASS/WARN/FAIL report with concrete fixes.

Frequently Asked Questions about skill:check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my SKILL.md file follows progressive disclosure rules?

To check progressive disclosure compliance, audit your SKILL.md file to validate line-count limits and references directory usage. This process produces a standardized PASS/WARN/FAIL report detailing structural issues and providing concrete fixes for content distribution.

What is the line-count limit for a SKILL.md file?

The line-count limit for a SKILL.md file is 100 lines to maintain progressive disclosure compliance. Auditing your file structure ensures concise content in the main file while moving detailed supporting content into the references/ directory.

How do I validate frontmatter in a SKILL.md file?

Frontmatter validity is checked during a SKILL.md audit by scanning the file's metadata headers. The validation process confirms frontmatter compliance and generates a remediation report template if structural issues are detected.

Why does my SKILL.md audit return a WARN status?

A SKILL.md audit returns a WARN status when progressive disclosure compliance is partially met, such as approaching the 100-line limit or improperly structuring references. The generated report provides concrete fixes to restructure content for full compliance.

When do I need to use a references directory for skill content?

You need to use a references directory when supporting content exceeds the concise scope of the main SKILL.md file. Auditing validates this distribution workflow, ensuring details live in references/ rather than bloating the primary file.