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.
How do I install this agent skill?
npx skills add https://github.com/dailybothq/deepworkplan-skill --skill fix-frontmatterIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a utility designed to maintain project standards by validating and fixing frontmatter metadata in SKILL.md files. It utilizes a local repository script and standard shell tools for its operations.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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
- Run
python3 scripts/validate-frontmatter.pyand read every reported issue. - For each flagged file, fix the frontmatter:
name:→ kebab-case, starts withdeepworkplan(e.g.deepworkplan-create)version:→ quoted SemVer ("2.8.0")- replace
homepage:withdocumentation_url: - ensure
---delimiters and the required keys exist
- 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/dailybothq/deepworkplan-skill/fix-frontmatter">View fix-frontmatter on skillZs</a>