Automates the generation of project documentation files from code state.

Install

mkdir -p .claude/skills/doc-socialgouv && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13183" && unzip -o skill.zip -d .claude/skills/doc-socialgouv && rm skill.zip

Installs to .claude/skills/doc-socialgouv

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.

Régénère la documentation utilisateur (`docs/*.md`) à partir de l'état courant du code. Usage : /doc (sur la branche courante) ou /doc <issue#> (sur la branche linkée à un epic / ticket).
187 charsno explicit “when” trigger
Intermediate

Key capabilities

  • →Regenerate user documentation (`docs/*.md`) from current code state
  • →Delegate documentation tasks to the `doc-writer` agent
  • →Operate on the current branch for local commits
  • →Operate on a ticket/epic branch for automatic commit and push
  • →Compare HEAD against `origin/alpha` for changes
  • →Handle dirty working trees by refusing to proceed

How it works

The skill regenerates user documentation by delegating to a `doc-writer` agent, which calculates code diffs, rewrites affected documentation files, and then commits changes locally or pushes them automatically based on the invocation mode.

Inputs & outputs

You give it
Current code state on a feature branch, or an issue number for a ticket/epic branch
You get back
Updated user documentation files (`docs/features.md`, `docs/architecture.md`, `docs/parcours-utilisateurs.md`) with local commit or automatic push

When to use doc

  • →Update docs from code
  • →Generate architecture docs
  • →Document feature updates

About doc

Delegates to a writer agent to update architecture and user documentation. Operates on branches and supports automated PR/commit flows.

Régénère la documentation utilisateur (`docs/*.md`) à partir de l'état courant du code. Usage : /doc (sur la branche courante) ou /doc <issue#> (sur la branche linkée à un epic / ticket).

When not to use it

  • →When operating directly on `alpha` or `master` branches
  • →When the diff versus base only contains test code, CI, or orchestration scripts

Limitations

  • →Refuses to run on `alpha` or `master` branches directly
  • →Refuses to run with a dirty working tree
  • →Does not regenerate documentation if only test code, CI, or orchestration scripts have changed

How it compares

This skill automates the regeneration of specific user documentation files based on the current code state, integrating with a `doc-writer` agent and handling different Git branch workflows, which is more structured than manual documentatio

Compared to similar skills

doc side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
doc (this skill)06moReviewIntermediate
ml-paper-writing489moReviewAdvanced
docs-review1011moNo flagsBeginner
claude-md-improver2110moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

ml-paper-writing

davila7

Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, structuring arguments, verifying citations, or preparing camera-ready submissions. Includes LaTeX templates, reviewer guidelines, and citation verification workflows.

4897

docs-review

metabase

Review documentation changes for compliance with the Metabase writing style guide. Use when reviewing pull requests, files, or diffs containing documentation markdown files.

1085

claude-md-improver

anthropics

Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".

2167

write-docs

tldraw

Writing SDK documentation for tldraw. Use when creating new documentation articles, updating existing docs, or when documentation writing guidance is needed. Applies to docs in apps/docs/content/.

665

update-docs

vercel

This skill should be used when the user asks to "update documentation for my changes", "check docs for this PR", "what docs need updating", "sync docs with code", "scaffold docs for this feature", "document this feature", "review docs completeness", "add docs for this change", "what documentation is affected", "docs impact", or mentions "docs/", "docs/01-app", "docs/02-pages", "MDX", "documentation update", "API reference", ".mdx files". Provides guided workflow for updating Next.js documentation based on code changes.

2543

wiki-architect

microsoft

Analyzes code repositories and generates hierarchical documentation structures with onboarding guides. Use when the user wants to create a wiki, generate documentation, map a codebase structure, or understand a project's architecture at a high level.

1144

Search skills

Search the agent skills registry