show-me
Show the current topic visually, inline in the conversation. Use when the user asks to see the shape of code, a flow, an architecture, or a change ("/show-me", "show me", "sketch it", "draw the flow",
Files2
View on GitHubSKILL.md.claude/skills/show-me/SKILL.md
GitHubshow-me
Explain the current topic visually, inline, with the smallest view that makes the point. Skip preamble; keep the prose around each visual to a sentence or two. Use one form, occasionally two — never a gallery.
The forms
- Pseudocode — logic or an algorithm, stripped to control flow. Fenced
text, indentation as structure. - Call tree — runtime control flow: caller above, callees indented below. One branch per line.
- Component tree — UI or module structure, with the file path and the hooks/state that matter in parentheses on the owning line.
- File tree — responsibility layout: a shallow tree with a
# one-phrase rolecomment per entry. Show only the directories the question touches. - Mermaid — interaction, sequence, or data flow between components. Renders only where the client supports it — never in a plain terminal (rule below); keep it under ~10 nodes.
- Whole block — real code, when most of it is new or the user needs a copyable target shape.
Diff shaped to the topic
The strongest device here: when the point is what changes and the surrounding shape already exists, show a fenced diff against that shape, not against raw source — a component tree with + lines for new components, a file tree with +/- for moved files, a call tree with the new call inserted, pseudocode with the changed branch. The reader sees the change in the structure they already hold.
Rules
- Place each visual immediately after the sentence it supports; include only the calls, files, props, or states the current question needs.
- Real names from the actual code — never invented placeholders.
- Prefer the text forms over Mermaid when the reader is in a terminal; prefer a table over any of these when the content is a flat list or comparison.
- Escalate to the html-artifact skill when its own "HTML when all hold" gate is met — never on a single criterion. Its
references/svg-craft.mdowns rendered figures; this skill never emits HTML.
Discovery
This is a manual skill. Some Codex integrations do not link this entrypoint; when explicitly requested by path, read this file directly. Adding a discovery link is separate integration work and must fit the authorized write scope.