Explanation Guidance

by testdouble

Explanation Guidance is a Writing skill for Claude Code, published by testdouble in han.

253 stars22 forkson testdouble/hanAdded 2026/09/02+9% in starsRepository updated 2026/09/01

View source on GitHub Download repo ZIP

claudeclaude-codeclaude-code-pluginclaude-skillscode-reviewdocumentationinvestigationplanningreview

Install in seconds

Install Explanation Guidance

Copy Explanation Guidance into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/testdouble/han/tree/main/han-communication/skills/explanation-guidance ~/.claude/skills/explanation-guidance

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/testdouble/han.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: han-communication/skills/explanation-guidance/SKILL.md in testdouble/han
Installs to: ~/.claude/skills/explanation-guidance
Collection: One of 25 skills cataloged from this repository
Category: Writing — 1060 skills

What Explanation Guidance does

Explanation Guidance helps you write escalations, confirmation turns, and stop prompts as outcomes a non-implementer can observe. Use it when explaining a technical consequence or asking for input from someone who will not open the code.

Explanation Guidance is cataloged under Writing on DirSkills. Explanation Guidance comes from a repository tagged claude, claude-code, claude-code-plugin, claude-skills and code-review.

Documentation

README

Excerpt

Project Context

personal config directory: !bash "${CLAUDE_PLUGIN_ROOT}/scripts/han-config-dir.sh" 2>/dev/null || echo "$HOME/.claude"
project .han/config.md: !cat .han/config.md 2>/dev/null || echo ""

As your first action, use the Read tool on .han/config.md inside the personal config directory path above. A read that returns no file is no personal configuration: continue silently. When that file or the project .han/config.md probe supplies content, apply it per config-rule.md, which governs precedence between the two files, relative-path resolution, and what to do with a file that reads but cannot be used.

Explanation Guidance

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Explanation Guidance

What else does testdouble publish alongside Explanation Guidance?
Explanation Guidance is one of 25 skills that DirSkills catalogs from testdouble/han, the repository it ships in. Its siblings there include Architectural Analysis, Automated Test Planning and Code Overview. Each one is a separate skill with its own page in this directory, installs the same way Explanation Guidance does, and is maintained by testdouble in that same repository. The rest of the collection is listed on the testdouble/han page.
How does Explanation Guidance compare to other Writing skills?
Explanation Guidance ranks #863 by stars among the 1060 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Explanation Guidance against them. Open each page to compare what they document and how they install.