mcpField
F
fix-frontmatter

fix-frontmatter

github.com/dailybothqTesting & quality2349 installsUpdated 2d ago
Repository

About fix-frontmatter

A skill for developers maintaining `SKILL.md` files and resolving CI validation failures. It uses a validator to identify frontmatter issues, guides the required fixes, and repeats validation until the files pass.

Key features

  1. 01Run the frontmatter validation script
  2. 02Fix names and version formatting to spec
  3. 03Replace homepage with documentation_url
  4. 04Check delimiters and required fields
  5. 05Repeat validation until it passes

Use cases

  1. 01Check formatting after adding or editing SKILL.md
  2. 02Resolve CI frontmatter validation failures
  3. 03Fix flagged files under skills/

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dailybothq/deepworkplan-skill --skill fix-frontmatter

After installing, type/fix-frontmatterin Claude Code to confirm it loaded.

Details

From the project README

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.

Comments

Markdown supported