documentator

Generate and update structured Markdown documents with frontmatter metadata and footers.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/benjaminhaeberli/claude-plugins --skill documentator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentator
Source: https://github.com/benjaminhaeberli/claude-plugins/tree/main/skills/general/documentator
Command: npx skills add https://github.com/benjaminhaeberli/claude-plugins --skill documentator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation and updating of structured Markdown documentation, including PRDs, guides, and architecture notes, to keep teams aligned and reduce manual drafting time.

Core Features & Use Cases

  • Generate new Markdown documents from user prompts (PRDs, guides, decision records) with consistent structure.
  • Update existing docs while preserving formatting and frontmatter metadata.
  • Respect output locations and naming conventions, including date prefixes and topic slugs, for easy discovery.
  • Use-case: when onboarding a feature, generate a PRD with objectives, context, requirements, and acceptance criteria.

Quick Start

Provide a brief description of the document you want (type, subject, scope). The assistant will propose a target path (e.g., /docs/tasks/YYMMDD_topic.md), create a markdown file with a frontmatter block, and append a footer with the last updated date.

Frequently Asked Questions about documentator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate structured Markdown documentation from a brief description?

To generate structured Markdown documentation, provide a brief description of the document type and scope. The skill creates a markdown file with a frontmatter block, required headings, and a footer noting the last update date.

How do I update existing Markdown docs without losing frontmatter metadata?

Updating existing Markdown docs preserves your formatting and frontmatter metadata automatically. The skill modifies the content sections while keeping the original metadata block intact and appending an updated footer date.

Can I automatically create a PRD with objectives and acceptance criteria?

You can automatically create a PRD with objectives and acceptance criteria by providing the feature scope. The skill structures the product requirements document with the required headings and frontmatter metadata.

What is the best way to organize Markdown guides with consistent naming conventions?

Organizing Markdown guides with consistent naming conventions is handled by proposing a target path like /docs/tasks/YYMMDD_topic.md. This ensures easy discovery using date prefixes and topic slugs for your files.

Do I need any specific dependencies to draft architecture notes?

You do not need any specific dependencies to draft architecture notes. The skill operates independently to generate and structure your documentation with frontmatter and sectioned content.

Does generating Markdown files with frontmatter work for engineering and design teams?

Generating Markdown files with frontmatter works for engineering, product, and design teams. It rapidly drafts and revises structured documents like guides and decision records to keep teams aligned.