| name | agent-docs-kit-glossary |
| description | Regenerate and review the glossary in an agent-docs-kit Fumadocs project. Use whenever MDX frontmatter terms were added, changed, duplicated, renamed, or need consistency cleanup before docs are committed. |
agent-docs-kit-glossary
Use this skill only inside a project that has .agent-docs-kit/config.json. If that file is missing, tell the user to run agent-docs-kit init first.
Workflow
- Read
.agent-docs-kit/config.json.
- Inspect frontmatter
terms in the relevant MDX files.
- Normalize duplicate terms only when they clearly mean the same project concept.
- Run:
uvx agent-docs-kit glossary
uvx agent-docs-kit check
- If the generated glossary looks wrong, fix source page frontmatter rather than hand-editing
glossary.mdx.
Write Safety
- Do not hand-edit the generated glossary except to replace it by rerunning the script.
- Do not merge two terms when they may represent different project concepts.
- Preserve the language and naming style already used in nearby docs unless the user asks for a rename.
Report the generated glossary path, any source frontmatter changed, and validation result.