# Backfill Metadata

> Write a Docusaurus page's `description` and `keywords` frontmatter from the page's own content — length and form rules, and what makes a keyword worth indexing. Load when filling metadata on an existing page rather than authoring a new one.

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

---


# Page Metadata

The field rules are provided verbatim in the backfilling agent's instructions (single source of
truth: `references/rules.md`). They carry the `description` length and register, the `keywords` count,
casing and block-list form, and the editing mechanics that keep an existing frontmatter block intact.

Nothing mounts this skill today: `src/metadata.ts` imports the reference directly, because a
single-purpose agent needs it on turn 1 of every run and progressive disclosure would only add a turn
and a way to skip it. The directory is a skill so that a consumer which needs it *sometimes* can
mount it without moving any content.

The full four-field frontmatter contract lives in `src/subagents/drafter.md`, which authors pages
from scratch. This skill deliberately restates only the two fields a backfill writes — the two
readers need different prose, and `drafter.md` is the named owner of anything they share.