Fix Frontmatter

Run the frontmatter validator and fix any SKILL.md that violates the repo's frontmatter contract. Use after editing or adding a SKILL.md.

dailybothq e5779e7 1.2 KB Updated

File contents

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.

dailybothq/deepworkplan-skill/tree/main/.agents/skills/fix-frontmatter commit e5779e7c9e

Frequently asked questions

npx skillmds@latest add dailybothq/fix-frontmatter