Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
dailybothq avatar

Fix Frontmatter

  • 34 installs
  • 19 repo stars
  • Updated July 16, 2026
  • dailybothq/deepworkplan-skill

Runs the frontmatter validator and fixes any SKILL.md that violates the repo's frontmatter contract so the CI validation job passes.

About

Runs scripts/validate-frontmatter.py and repairs SKILL.md frontmatter (name, quoted version, documentation_url, delimiters) until validation exits clean. A developer uses it after adding or editing a SKILL.md or when the CI frontmatter check fails.

  • Enforces kebab-case name, quoted SemVer version, documentation_url over homepage
  • Never edits version numbers to pass; only fixes quoting/format

Fix Frontmatter by the numbers

  • 34 all-time installs (skills.sh)
  • Ranked #391 of 782 Skill Development skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/dailybothq/deepworkplan-skill --skill fix-frontmatter

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs34
repo stars19
Last updatedJuly 16, 2026
Repositorydailybothq/deepworkplan-skill

What it does

Runs the frontmatter validator and fixes any SKILL.md that violates the repo's frontmatter contract so the CI validation job passes.

Files

SKILL.mdMarkdownGitHub ↗

Fix Frontmatter

Goal

Bring every SKILL.md under skills/ back into conformance with the frontmatter contract that CI enforces, so scripts/validate-frontmatter.py passes.

When to use

After adding or editing any SKILL.md, or when CI's "SKILL.md frontmatter validation" job fails.

Steps

1. Run python3 scripts/validate-frontmatter.py and read every reported issue. 2. For each flagged file, fix the frontmatter:

  • name: → kebab-case, starts with deepworkplan (e.g. deepworkplan-create)
  • version: → quoted SemVer ("2.8.0")
  • replace homepage: with documentation_url:
  • ensure --- delimiters and the required keys exist

3. Re-run the validator until it prints OK: all N SKILL.md file(s) validated.

Validation

python3 scripts/validate-frontmatter.py exits 0.

Notes

Never edit a version: number to make the check pass — fix only quoting or format. The auto-release.yml bot owns version numbers (AGENTS.md §4). The validator scans skills/ only; .agents/skills/* is not CI-gated but follows the same style.

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.