Menu
Update documentation after code changes. Scans git diff to find affected docs and updates them for consistency.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | update-docs |
| description | Update documentation after code changes. Scans git diff to find affected docs and updates them for consistency. |
This skill activates for:
/update-docsRead .claude/roles/documentalist.md — adopt this profile and follow all its rules.
# Default: last 5 commits. The user can specify a range.
git diff --name-only HEAD~5
Filter relevant files (ignore: tests, configs, lock files).
Two strategies, in this order:
Strategy A — Frontmatter related (priority):
# Read the frontmatter of each doc
Glob docs/**/*.md
# Look for modified files in the `related` field
Strategy B — Keyword search (fallback):
mcpServerStdio.ts changed, search for "mcp", "server", "stdio" in docsFor each potentially affected doc:
| Question | If Yes |
|---|---|
| Has the documented behavior changed? | Update required |
| Has a documented API/interface changed? | Update required |
| Only internal implementation changed? | No update needed |
| Has a new concept appeared? | Suggest /create-doc |
For each doc to modify:
last-updated in the frontmatterrelated entries are up to date (add new files if needed)If a doc has no YAML frontmatter, add it following the template from PERSONA.md.
This is a progressive migration — no need to do everything at once.
List the modifications made:
## Docs Updated
| File | Changes | Reason |
|------|---------|--------|
| docs/MCP-TOOLS-REFERENCE.md | Updated tool parameters | mcpServerStdio.ts changed |
| docs/ARCHITECTURE.md | No update needed | Internal refactor only |
/audit-docs firstFollow-up review that never trusts a commit message — always re-reads the actual diff before resolving a thread. Cites a real source for new issues, matching review-advanced.
Rigorous sequential-audit code review with a dedicated security block and cited pedagogical lessons. Customize for your project.
Review de suivi qui ne fait jamais confiance à un message de commit — relit toujours le diff réel avant de résoudre un thread. Cite une source réelle pour les nouveaux problèmes, comme review-advanced.
Code review rigoureuse à audits séquentiels, avec bloc sécurité dédié et leçons pédagogiques sourcées. À personnaliser pour votre projet.
Complete review of a documentation-focused MR/PR with 5 sequential audits oriented for documentation projects (markdown-quality, link-validity, terminology, freshness, examples-validity). No code-architecture audits, no React patterns, no SOLID. An orchestrator runs each audit one by one. Generates an .md report and posts it directly on the MR/PR. Direct mode with sourced lessons.
Follow-up review to verify corrections on a MR. Sequential execution to avoid memory spikes. Checks blocking issues, detects new problems, and posts a concise report on GitLab.