Agent skill

Clarify Docs

by serpro69 in serpro69/claude-toolbox

TRIGGER when: asked to clarify or improve the explanation in existing local human documentation, such as a guide, design document, or implementation plan.

Custom licenceAuto-check passedAgent Workflows

Install Clarify Docs

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install serpro69/claude-toolbox clarify-docs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/serpro69/claude-toolbox.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/feat/done/clarify-docs/verification/task1-20260929/instructions .claude/skills/clarify-docs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clarify-docs
GitHub stars
151
Token cost
~712 tokens
SKILL.md length
314 words
Files
2
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

TRIGGER when: asked to clarify or improve the explanation in existing local human documentation, such as a guide, design document, or implementation plan.

  • Works in 4 steps: Load shared-document-clarity.md in full. → Resolve the selected artifacts, reader,… → Apply the shared procedure in order:… → …
  • : asked to clarify
  • SKILL.md covers Inputs and boundaries and Workflow
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Clarify Docs is an agent skill from serpro69/claude-toolbox. TRIGGER when: asked to clarify or improve the explanation in existing local human documentation, such as a guide, design document, or implementation plan. Grounds edits in requirements and source while preserving technical meaning. Not for code, config, generic response brevity, PR drafts, or agent instructions. Explicit instruction or SKILL.md targets receive a /kk:implement suggestion without edits or automatic handoff.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `shared-document-clarity.md`).

It sits in Agent Workflows, covering Agent instruction files and Planning. The repository describes itself as: Minimal by design, explicitly multi-lang, production-ready and battle-tested collection of configs and plugins for your Claude Code agentic development workflows: mcp, configs…

When your agent uses it

  • : asked to clarify
  • Improve the explanation in existing local human documentation
  • Such as a guide
  • Design document

Example prompts

  • “/clarify-docs”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Load shared-document-clarity.md in full.
  2. Resolve the selected artifacts, reader, purpose and destination from the request
  3. Apply the shared procedure in order: understand the relevant work, establish
  4. Report changed paths and material unresolved gaps briefly. If no edit was needed,

What it can do on your machine

Read from SKILL.md and the folder at commit c2d28c9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clarify Docs loads about 712 tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 314 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~110
When it runs · the whole SKILL.md, loaded when a task matches
~712

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 314 words (~712 tokens).

“Improve an existing document so its intended reader can understand the underlying work. Edit the selected artifact in place; success depends on comprehension and fidelity, with no document-length target.”

— opening of SKILL.md by serpro69, Custom licence
name
clarify-docs

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in docs/feat/done/clarify-docs/verification/task1-20260929/instructions of serpro69/claude-toolbox.

  • SKILL.md
  • shared-document-clarity.md

Open the folder on GitHubat commit c2d28c9

Compare with similar skills

Clarify Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clarify Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clarify Docs this skillserpro69/claude-toolbox151—~712Automated safety check: PassCustom licence
Init My ProjectMCSLTeam/MCServerLauncher-Future121—~2.1kAutomated safety check: PassGPL-3.0
Project Prompt CreatorPhilip-Cao-9527/code-note-helper273—~693Automated safety check: PassMIT
Business Problem To Blueprintzanecole10/software-tailor-skills104—~2.7kAutomated safety check: PassNone
Handoffanombyte93/prd-taskmaster604—~5kAutomated safety check: PassMIT
Agent Workflowmenkesu/awesome-pm-skills429—~5.2kAutomated safety check: PassCustom licence

Similar skills

  • Init My Project

    MCSLTeam/MCServerLauncher-Future

    Bootstrap reusable project governance for a new or existing repo.

    121 GitHub stars~2.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Project Prompt Creator

    Philip-Cao-9527/code-note-helper

    在项目 AGENTS.md 约束下生成可直接交给 Codex 或 Agent 执行的中文任务 prompt。用于开发、修复、文档、验证、审计、治理或交接任务的 prompt 化,但不承载 Plan mode 和 code review 的完整模式规则。

    273 GitHub stars~693 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Business Problem To Blueprint

    zanecole10/software-tailor-skills

    Transform any boring B2B business problem into a complete software blueprint with architecture, database schema, feature breakdown, and step-by-step implementation plan formatted as a CLAUDE.md file…

    104 GitHub stars~2.7k tokensUpdated 11 mo ago
    Agent WorkflowsAuto-check passed
  • Handoff

    anombyte93/prd-taskmaster

    Phase 3 of the prd-taskmaster pipeline: smart mode selection and user handoff.

    604 GitHub stars~5k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Agent Workflow

    menkesu/awesome-pm-skills

    Sets up how you and your team build and work with AI agents, and produces an Agent Workflow Charter (agent lanes, plan-mode loop, autonomy ladder with promotion criteria, rules file, review policy…

    429 GitHub stars~5.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Megingiard Code Review

    stormpanda/megingiard

    Conduct a thorough code review of the current Git branch or specific files in Megingiard.

    154 GitHub stars~2.9k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from serpro69/claude-toolbox

All 12 skills in this repo
  • Chain Of Verification

    serpro69/claude-toolbox

    Apply Chain-of-Verification (CoVe) prompting to improve response accuracy through self-verification.

    151 GitHub stars~1.7k tokensUpdated 4 days ago
    Auto-check passed
  • Diff Skill

    serpro69/claude-toolbox

    Compare two versions of a skill's instructions to detect degradations and complexity increases.

    151 GitHub stars~617 tokensUpdated 4 days ago
    Auto-check passed
  • Review Code

    serpro69/claude-toolbox

    Code review of current git changes with an expert senior-engineer lens.

    151 GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check passed
  • Brainstorm

    serpro69/claude-toolbox

    TRIGGER when: asked to brainstorm, think through, explore, or pressure-test a technical idea or decision through conversation.

    151 GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check passed
  • Clarify Docs

    serpro69/claude-toolbox

    TRIGGER when: asked to clarify or improve the explanation in existing local human documentation or a PR-description draft, including a PR URL or pasted body.

    151 GitHub stars~910 tokensUpdated 4 days ago
    Auto-check passed
  • Clarify Docs

    serpro69/claude-toolbox

    TRIGGER when: asked to clarify or improve existing documentation, PR drafts or issue descriptions, including URLs and pasted bodies.

    151 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about Clarify Docs

What does Clarify Docs do?

TRIGGER when: asked to clarify or improve the explanation in existing local human documentation, such as a guide, design document, or implementation plan. Clarify Docs is an agent skill from serpro69/claude-toolbox. TRIGGER when: asked to clarify or improve the explanation in existing local human documentation, such as a guide, design document, or implementation plan.

When should I use Clarify Docs?

Clarify Docs fits situations like: : asked to clarify; improve the explanation in existing local human documentation; such as a guide; design document.

How do I install Clarify Docs in Claude Code?

Run `npx skills add serpro69/claude-toolbox --skill clarify-docs -a claude-code`. Or copy the skill folder (docs/feat/done/clarify-docs/verification/task1-20260929/instructions in serpro69/claude-toolbox) into .claude/skills/clarify-docs in your project. Claude Code loads it when a task matches its description.

How do I install Clarify Docs in Codex?

Run `npx skills add serpro69/claude-toolbox --skill clarify-docs -a codex`. Or copy the skill folder (docs/feat/done/clarify-docs/verification/task1-20260929/instructions in serpro69/claude-toolbox) into .agents/skills/clarify-docs in your project. Codex loads it when a task matches its description.

Can I use Clarify Docs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add serpro69/claude-toolbox --skill clarify-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clarify-docs, .gemini/skills/clarify-docs, .github/skills/clarify-docs and .opencode/skills/clarify-docs in your project.

What does Clarify Docs need to run?

SKILL.md names no scripts, command-line tools or credentials: Clarify Docs is instructions for the agent only.

Does Clarify Docs access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Clarify Docs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clarify Docs use?

Clarify Docs has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Clarify Docs use?

About 712 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Clarify Docs?

Skills that share tags, products or a category with Clarify Docs: Init My Project (MCSLTeam/MCServerLauncher-Future, 121 stars), Project Prompt Creator (Philip-Cao-9527/code-note-helper, 273 stars), Business Problem To Blueprint (zanecole10/software-tailor-skills, 104 stars) and Handoff (anombyte93/prd-taskmaster, 604 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clarify Docs?

serpro69 (a GitHub user) maintains it in serpro69/claude-toolbox, which has 151 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 3, 2026.

Source: serpro69/claude-toolbox on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.