missing-level1

Detect missing Level 1 sections in Skill Unit documentation with YAML front matter.

17|1|Updated Jun 8, 2025
One-click install
npx skills add https://github.com/williamzujkowski/standards --skill missing-level1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: missing-level1
Source: https://github.com/williamzujkowski/standards/tree/main/tests/scripts/fixtures/skills/missing-level1
Command: npx skills add https://github.com/williamzujkowski/standards --skill missing-level1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps identify and flag documentation that is incomplete or missing critical sections, ensuring all project documentation meets required structural standards without manual review.

Core Features & Use Cases

  • Structural Validation: Automatically checks for the presence of mandatory sections (e.g., Level 1 Quick Start).
  • Early Detection: Integrates into CI/CD to catch documentation gaps before deployment.
  • Use Case: Use this skill to scan your project's SKILL.md files and report any that are missing the "Level 1: Quick Start" section, ensuring new skills are always properly introduced.

Quick Start

Check the attached 'new-skill.md' for missing Level 1 sections.

Frequently Asked Questions about missing-level1

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

FAQPage Schema
How do I validate that documentation has all required Level 1 sections?

Structural validation automatically checks for mandatory sections like Level 1 Quick Start in your Skill Unit files. Parse YAML front matter and Markdown headers to detect missing Level 1 content, then generate a report specifying gaps and remediation steps.

Can I catch documentation gaps before deployment?

Yes, integrate this validation into CI/CD workflows to detect incomplete documentation automatically. The validator scans Skill Unit files containing YAML front matter and Level 2 notes, flagging missing Level 1 schemas before code reaches production.

What makes documentation complete for a Skill Unit?

Complete Skill Unit documentation requires a Level 1 Quick Start section alongside Level 2 implementation notes. The validator checks that both YAML front matter structure and markdown headers conform to required standards, ensuring consistent documentation quality across projects.

How does the validator identify incomplete documentation?

The validator parses YAML front matter, scans Markdown headers for section structure, and compares against the required Level 1 schema. It outputs a concise report listing missing sections and actionable remediation guidance for developers to complete documentation.

Can I use this for existing documentation or only new skills?

Apply validation to any Skill Unit file with YAML front matter and Level 2 implementation notes, whether newly created or already published. Scan your project's SKILL.md files to identify any missing Level 1 Quick Start sections and remediate gaps.