# 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.

- Skill: `dailybothq/fix-frontmatter` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dailybothq/fix-frontmatter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dailybothq/fix-frontmatter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dailybothq (https://skillmd.com/u/dailybothq)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dailybothq/fix-frontmatter

---


# 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.