Skip to main content
skill CX Codex

clarify-docs — Claude Code skill: what it does, how to install

clarify-docs revises documentation, pull request drafts, and issue descriptions without changing their intended meaning. Use it when the writing needs clarification rather than implementation.

no license ★ 155 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add serpro69/claude-toolbox --skill clarify-docs -a claude-code
Open on GitHub

What clarify-docs does

clarify-docs edits a selected local document, PR draft, or issue description. It can use pasted text or a remote URL when the request provides a destination for the revised copy. The skill works from the intended reader, purpose, requirements, and supporting source material, then checks whether the result remains understandable and faithful.

Its workflow starts by loading shared-document-clarity.md. It then resolves the target artifact, audience, purpose, and destination before examining related work and editing the document’s reading path. A directory is used to discover a candidate file, not to rewrite everything in bulk.

Code, configuration, AGENTS.md, CLAUDE.md, and agent or skill instructions are outside this entry point. An explicit request to edit such instructions gets a $kk:implement suggestion without an automatic handoff. A URL by itself does not establish an editing task, so the skill asks for clarification before choosing one.

What it helps with

  • clarify docs for a defined reader
  • rewrite a PR draft while retaining its meaning
  • turn an issue description into a clearer draft
  • save revised remote or pasted content locally

Example prompts for the agent

  • Run $kk:clarify-docs on docs/configuration.md for service owners, using src/config/ as source context.
  • Revise pr-draft.md for repository reviewers and keep the actual PR base/head details.
  • Take the issue URL and save the edited body to docs/feat/wip/import/issue-draft.md.

How to install clarify-docs

1Skills CLI (Vercel)

npx skills add serpro69/claude-toolbox --skill clarify-docs -a claude-code

2Manually: put the files in place

~/.claude/skills/clarify-docs/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/clarify-docs/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about clarify-docs

How do I install clarify-docs in Claude Code?

Run npx skills add serpro69/claude-toolbox --skill clarify-docs -a claude-code, then check ~/.claude/skills/clarify-docs/SKILL.md.

What does clarify-docs do?

It revises documentation, pull request drafts, and issue descriptions for a stated reader and purpose. The edited result is written locally while the original meaning is preserved.

Can clarify-docs edit AGENTS.md or source code?

Those targets are outside the skill’s scope. For an explicit instruction-editing request, it suggests $kk:implement and does not invoke it automatically.

Similar skills

All skills for Writing and docs →
tailwind-4-docs Lombiq The tailwind-4-docs skill syncs a local snapshot of the Tailwind CSS v4 docs so your agent answers utility, config and v3-to-v4 migration questions from official text. CX Codex +1 19,300installs developer-troubleshooting-docs Samuel Berthe developer-troubleshooting-docs turns support tickets, issue history and error telemetry into pages a developer lands on by pasting the error string. Useful when the team answers the same question every week. CX Codex +1 13,400installs coding-agent-docs-optimization Samuel Berthe coding-agent-docs-optimization is a Claude Code skill that checks whether an agent can integrate an SDK or API using its documentation alone. It runs for requests about agent-ready docs, llms.txt, or fabricated API calls. CX Codex +1 13,400installs openai-docs official openai The openai-docs skill finds current OpenAI guidance for API work, Codex, model selection, migrations, and prompt updates, using official documentation. CX Codex +1 7,300installs platform-docs-get forcedotcom platform-docs-get pulls official Salesforce documentation and keeps the agent answering from it instead of third-party blogs. Useful when pages are JS-heavy and a plain fetch returns an empty shell. CX Codex +1 6,900installs coralogix-docs coralogix coralogix-docs — a skill to search and fetch official Coralogix platform documentation via cx docs search and cx docs fetch commands. Available on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. CX Codex +1 5,000installs

From the same set30

The whole set →
isolated Runs an isolated multi-model code review on git changes. Evaluates security, compatibility, and design rules across separate reviewers. CX Codex +1 ★ 155repo stars dependency-handling The dependency-handling skill makes an agent verify dependency details before writing code that uses them. It helps when adding or upgrading a library, API, IaC version, CRD, or container image. CX Codex +1 ★ 155repo stars migrate migrate — a slash command that takes a project off Task Master MCP and onto task files in markdown, carrying open tasks over before clearing the old setup. CX Codex +1 ★ 155repo stars document Updates project documentation and architectural decisions after delivering a feature or bug fix following profile guidelines. CX Codex +1 ★ 155repo stars profile-resolver profile-resolver — a subagent that reads a diff and the worktree, works out which project profiles are active, and reports which checklists load. Handy when detection has to run apart from the review. CX Codex ★ 155repo stars brainstorm brainstorm guides technical ideation and architecture debates by asking focused questions one at a time before any code gets written. CX Codex +1 ★ 155repo stars design design is a Claude Code skill that turns requirements into design documents and task plans before coding begins. It can also resume a feature in docs/feat/wip/. CX Codex +1 ★ 155repo stars model model reads one bounded context and leaves a glossary, a traps page, and a queue of questions that need a human answer. CX Codex +1 ★ 155repo stars

Project sponsors

Companies that keep this analytics open