{"slug":"explanation-guidance","title":"explanation-guidance","summary":"Surfaces Han's shared standard for explaining technical work to a reader who will not implement it into the calling skill's own context, so the caller writes its escalations, confirmation turns, and stops as a concrete outcome the reader could observe rather than as a mechanism. ","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-15T13:11:53.858763Z","repo":{"url":"https://github.com/testdouble/han","stars":303,"forks":24,"license":"MIT","updatedAt":"2026-10-14T20:22:28Z"},"bodyHtml":"
\n

name: explanation-guidance\ndescription: >\nSurfaces Han's shared standard for explaining technical work to a reader who will not implement it into the calling\nskill's own context, so the caller writes its escalations, confirmation turns, and stops as a concrete outcome the\nreader could observe rather than as a mechanism. Use when a skill is about to ask a person a question, stop for an\ninput, or explain a technical consequence to someone who will not open the code. Governs what a run says to a person\nin a turn, where readability-guidance governs the shape of a written deliverable. Runs in the caller's context and\nhands control straight back; it does not produce a deliverable of its own, rewrite anything, or judge the caller's\nwork. Carries guidance only and adds no self-check step.\nallowed-tools: Read, Bash(bash \"$/scripts/han-config-dir.sh\")

\n

Project Context

\n\n

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

\n

Explanation Guidance

\n

You have invoked explanation-guidance to source the shared explanation standard before you talk to a person. This skill\nsurfaces the standard into your own context and hands control back. It is a means to writing your turn, not the turn\nitself: apply what it surfaces, then RETURN to the workflow that called you and finish it.

\n

This skill is inline — it runs in your context, not an isolated one, so the standard it surfaces stays available to\nyou after it returns. Do not treat anything here as a stopping point or a final answer.

\n

When this standard applies

\n

It applies to what you say to a person in a turn: an escalation, an opening confirmation turn, a stop for a missing\ninput, or any explanation of a technical consequence to someone who will not implement the work.

\n

It does not apply to the written deliverable you are producing. That is governed by the readability standard, which you\nsource through han-communication:readability-guidance. A run often needs both, at different moments.

\n

Step 1: Read the standard

\n

Read ${CLAUDE_PLUGIN_ROOT}/references/explanation-rule.md so its full content enters your context. It carries the\nconcrete-outcome requirement, the four-part form for a question shaped like data entry, the unintroduced-term test, and\nthe rule that the consequence comes before the technical detail.

\n

Do not paraphrase or summarize the file in place of reading it. The surfaced content is the point.

\n

Step 2: Hold the reader while you write the turn

\n

Write for a reader who knows the product and will not open the code. Name something they could observe. Put paths,\nidentifiers, and line numbers below the question, or leave them out.

\n

Before you use a term, check whether it appears in the work item or in this conversation. If it appears in neither, it is\nunintroduced: replace it with a concrete outcome rather than defining it mid-turn.

\n

Step 3: Write the turn, then continue

\n

The standard carries guidance only. There is no self-check to run and no verification step to add, so apply it as you\nwrite rather than as a pass afterward.

\n

The standard is now in your context. Proceed to the next step of the skill that invoked you and finish its workflow.

\n","files":[{"path":"SKILL.md","sizeBytes":3796,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-15T13:12:02.370508Z","sha256":"34769AF232CF67A1C4B19D6EB2FACDBF2A39B5932D44975E21DA50ECBF56DAC5","sizeBytes":1802},"review":null,"source":{"repositoryUrl":"https://github.com/testdouble/han","path":"han-communication/skills/explanation-guidance","license":"MIT","commit":"abba73a773528905a8f3d15956029394746e5c7f","subtreeSha":"6D5F65FAAFB09A1773EE7500AB1DBCA1C51F6620B52D4621A70088D8F4AE0770","lastSyncedAt":"2026-10-15T13:11:53.672149Z"},"reviewedAt":"2026-10-15T13:12:20.921398Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/testdouble/han/tree/main/han-communication/skills/explanation-guidance"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install testdouble-han@llmmart"},{"target":"git","command":"git clone https://github.com/testdouble/han.git"}]}