docs-governance
Enforces documentation file structure and governance rules to prevent stray files.
Install
mkdir -p .claude/skills/docs-governance && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14523" && unzip -o skill.zip -d .claude/skills/docs-governance && rm skill.zipInstalls to .claude/skills/docs-governance
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Before creating, renaming, or moving any `.md` file outside `src/`, or when the user says \"stray docs\", \"docs governance\", \"where should this doc live\", or runs the stray-doc auditor: invoke `Skill('docs-governance')` and place the file using its vault-synced allowlist and filename-heuristic table.Key capabilities
- →Place non-code documentation in authorized paths
- →Identify and move stray `.md` files
- →Propose target locations using filename heuristics
- →Update internal links after moving files
- →Generate an inventory of skills, commands, and agents
How it works
The skill identifies stray `.md` files by comparing all `.md` files against an allowlist of authorized paths. It then uses filename heuristics to propose a target location and performs a `git mv` operation, updating internal links.
Inputs & outputs
When to use docs-governance
- →Fixing stray documentation files
- →Organizing project docs
- →Moving documentation to standard locations
About docs-governance
Ensures all non-code documentation lives in authorized paths. Syncs documentation into the vault to provide a central repository overview.
Before creating, renaming, or moving any `.md` file outside `src/`, or when the user says \"stray docs\", \"docs governance\", \"where should this doc live\", or runs the stray-doc auditor: invoke `Skill('docs-governance')` and place the file using its vault-synced allowlist and filename-heuristic t
When not to use it
- →The file is inline code comments in `src/**`
- →The file is a tool-specific config like `.github/copilot-instructions.md`
- →The file is a scoped `AGENTS.md` (e.g., `server/AGENTS.md`)
Limitations
- →Requires user confirmation before moving files
- →Does not automatically delete files; requires user decision
- →Filename heuristics are a guide, not a definitive rule
How it compares
This skill enforces a structured documentation governance policy by automatically identifying and relocating non-compliant `.md` files, ensuring all documentation is discoverable within a vault-synced system.
Compared to similar skills
docs-governance side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| docs-governance (this skill) | 0 | 4mo | Review | Beginner |
| marker | 22 | 8mo | Review | Beginner |
| markdown-converter | 5 | 4mo | Review | Beginner |
| enhance-claude-memory | 11 | 7mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
marker
benchflow-ai
Convert PDF documents to Markdown using marker_single. Use when Claude needs to extract text content from PDFs while preserving LaTeX formulas, equations, and document structure. Ideal for academic papers and technical documents containing mathematical notation.
markdown-converter
steipete
Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM processing or text analysis.
enhance-claude-memory
avifenesh
Use when improving CLAUDE.md or AGENTS.md project memory files.
doc-sync
solatis
Synchronizes docs across a repository. Use when user asks to sync docs.
wiki-sync
zoraxl
Use to sync the wiki from a merged PR or from a source doc/file path. Two modes — PR mode (post-merge: creates ADR if needed, flips ADR to accepted, updates wiki pages, appends log, records idempotency, archives related plan/source files) and doc mode (ingests existing implemented knowledge from a f
markdown-to-pdf
duc01226
[Document Processing] Use when you need to convert markdown files to PDF with syntax highlighting and custom CSS support.