mcpbeat Sign in

Document Agent Skill

| After implementing a new feature or fixing a bug, make sure to document the changes. Use when writing documentation, after finishing the implementation phase for a feature or a bug-fix.

4k tokens
context cost
the whole folder, loaded on every use
3
files
instructions only
0
copies elsewhere
how many repositories repackaged it
147
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/serpro69/claude-toolbox --skill document

What comes with it

10 461 bytes besides the instruction
shared-capy-knowledge-protocol.md
shared-profile-detection.md

The instruction itself

4 sections, as written by the author

<!-- codex: tool-name mapping applied. See .codex/scripts/session-start.sh -->

Documentation Process

Conventions

  • Read capy knowledge base conventions at shared-capy-knowledge-protocol.md.
  • Read profile detection at shared-profile-detection.md. When an active profile contributes a document/ subdirectory (e.g., ../../profiles/k8s/document/), its index.md lists a doc rubric — required topics the documentation for that artifact type must cover. See the Workflow below for the load order.

Workflow

Mandatory order — instructions before action. The flow below is strictly sequential. Do not read feature-tree content, write, or edit documentation files until profile detection has completed and all resolved profile content is in context.

  • Minimal-scope listing. List the feature directory (filenames and metadata only — no file-content reads). This is the input profile detection needs, and nothing more; content-level reading happens after profile content is loaded.
  • Detect active profiles. Run the shared-profile-detection.md procedure against the filename list from Step 1.
  • Load profile content. For each active profile that contributes a document/ subdirectory, load ../../profiles/<name>/document/index.md and read its always-load + any matching conditional content. The rubric named there specifies topics the documentation must cover for that profile's artifacts.
  • Read the feature-tree content the documentation will cover. This is the first step that touches subject-matter content; the profile rubric is now loaded and frames what to look for.
  • Apply the doc guidelines below. Write or update documentation applying the rubric's required topics where applicable.

Guidelines

  • Discover the project's documentation structure. List top-level doc directories and doc-related files at the repo root (e.g., docs/, README.md, ARCHITECTURE.md, CONTRIBUTING.md). Scan for architecture guides, testing guides, API docs, user guides, and contributing docs — common locations include docs/contributing/architecture.md, docs/contributing/testing.md, but every project organizes differently. Update whichever docs are relevant to the change — don't limit yourself to a fixed set of paths.
  • If the code change included prior decision-making out of several alternatives, document an ADR at /docs/adr for any non-trivial/non-obvious decisions that should be preserved.
  • Profile-aware rubric. For each active profile, apply the doc rubric its document/index.md specifies (loaded in Step 3 of the Workflow). Each required topic must be addressed in one of three ways: (a) write the topic if the feature touches it, (b) state N/A — <reason> in a single line if the feature does not touch the topic, or (c) cite the inherited source explicitly if the feature assumes the topic but inherits it from elsewhere (e.g., NetworkPolicy defined in a platform repo). Silent omission is the failure mode — an explicit N/A communicates consideration; an absent heading communicates nothing.

Capy search: Before writing docs, search kk:arch-decisions and kk:project-conventions for decisions that should be reflected in documentation — decisions not obvious from code alone.

Other skills for the same job

different authors, same section of the catalogue
DOCX
by anthropics
vendor ×16

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

7k tokens
PDF
by anthropics
vendor ×16

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

13k tokens scripts
PPTX
by JayZeeDesign
×15

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

308k tokens scripts
Canvas Design
by anthropics
vendor ×13

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

1388k tokens
PDF
by anthropics
vendor ×10

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

15k tokens scripts
DOCX
by w95
×6

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

5k tokens
PPTX
by w95
×4

Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx filename, regardless of what they plan to do with the content afterward. If a .pptx file needs to be opened, created, or touched, use this skill.

2k tokens
Obsidian Markdown
by ZhanlinCui
×3

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

3k tokens

How to use it

Copy the folder

Take serpro69/claude-toolbox-document from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.