show-me
- Use it when:
- A discussion about code is hard to follow in prose and you want to see its shape.
- It does:
- Picks the smallest visual that makes the point: pseudocode, a call tree, a component or file tree, a Mermaid diagram or a diff.
- You get:
- Brief text with each visual beside it; for dense UI or concepts, one HTML diagram, infographic or short slide deck it opens for you.
- Runs:
- Only when you call it with /show-me.
TL;DR
From HumanLayer's skills. It answers the topic you're already discussing in pictures rather than paragraphs, with no preamble. Logic becomes pseudocode, runtime flow a call tree, UI a component tree with the state and module boundaries that matter, file responsibilities a shallow file tree, and interactions between parts a Mermaid diagram. When the point is what changes, it shows a diff in the matching shape: components, files, calls or state. A whole block of code appears only when most of it is new or you need a shape to copy. For a visual UI, a layout or a concept too dense for Mermaid, it writes one HTML file that matches your product's colors, type, spacing and components, uses real labels and data, works on desktop and mobile, and opens it with the open command. It keeps only the calls, files and states your question needs, and usually uses one or a few of these, rarely all.
Summarizes the skill at 4d69d20.
npx skills add https://github.com/humanlayer/skills --skill show-me skills.sh pageSource on GitHubAll skills from humanlayer/skills
- Total Downloads
- 36,100 on skills.sh, Nov 9, 2026
- Repo stars
- 5,673 humanlayer/skills
- First seen
- Aug 10, 2026 on skills.sh
Weekly values
| Week to | Installs |
|---|---|
| Sep 21 | 2,996 |
| Sep 28 | 2,386 |
| Oct 5 | 2,673 |
| Oct 12 | 3,379 |
| Oct 19 | 2,240 |
| Oct 26 | 2,085 |
| Nov 2 | 1,800 |
| Nov 9 | 1,887 |
| Category |
Change how the agent replies: shorter, clearer, fewer tokens. Everything for building software: planning, coding, debugging, design, frameworks, cloud, agents and skills. |
|---|---|
| Type |
A one-shot action you invoke by name, such as turning the conversation into a PRD. |
| Effect |
Its own steps create or change files, git state or local tools. |
| Needs |
Instructions only. Works in any agent that supports skills. |
| Publisher |
Everyone else. Unverified vendor claims default to community. |
| Topics |
SKILL.md
From humanlayer/skills at 4d69d20. Checked daily, last changed Nov 6, 2026.
Frontmatter
name: show-me
description: Help the user understand the current topic visually with concise diagrams, code-shape sketches, and focused HTML artifacts.
disable-model-invocation: trueHelp the user understand the current topic of conversation visually. Skip the preamble and keep prose brief. Pick the smallest view that makes the key point clear.
- Show logic or an algorithm as pseudocode:
on(save)
if content is unchanged
return cached result
write new content
return fresh result
- Show runtime control flow as a call tree:
submitForm
createSession
persistPrompt
launchAgent
navigateToSession
- Show UI structure as a component tree, including state and module boundaries that matter:
<SessionPage> (apps/example/src/routes/session.tsx)
useSessionEvents()
<SessionToolbar>
<RunSkillButton> (packages/ui)
- Show file responsibility or a broad refactor as a shallow file tree:
src/
├── commands/ # parses user actions
├── sessions/ # owns session state
└── transport/ # sends API requests
- Show component interaction, control flow, or data flow with Mermaid:
sequenceDiagram
participant User
participant UI
participant Daemon
User->>UI: choose command
UI->>Daemon: send expanded prompt
Daemon-->>UI: stream result
- Use
diffwhen the point is what changes and the surrounding shape already exists. Match the diff shape to the topic.
For a component change:
<SessionPage>
useSessionEvents()
<SessionToolbar>
+ <RunSkillButton />
<SessionTimeline>
+ <SkillResultCard />
For a file-layout change:
src/
├── commands/
+│ └── show-me.ts # expands the slash command
├── sessions/
-└── transport.ts
+└── transport/
+ ├── client.ts
+ └── stream.ts
For a call-tree or call-stack change:
submitForm
createSession
persistPrompt
+ expandSkillMention
launchAgent
- navigateToSession
+ navigateToSession
+ subscribeToEvents
For a state or control-flow change:
on(save)
- write content
+ if content is unchanged
+ return cached result
+ write new content
+ invalidate cache
- Show the whole block when most of it is new, when omitted context would hide ownership or order, or when the user needs a copyable target shape:
function expandSkill(command: string): string {
const skillName = command.slice(1)
return `use the ${skillName} skill`
}
- For a visual UI, layout, state comparison, or concept too dense for Mermaid, write one focused HTML file — a diagram, an infographic, or a short slide deck, whichever fits the point. Match the product's colors, type, spacing, and components; use real labels and data; support desktop and mobile. Then open it for the user:
Bash(open path/to/show-me-{description}.html)
guidance
Place each visual next to the short text it supports. Keep only the calls, files, props, states, and boundaries needed to answer the user's current question or the options to resolve the current discussion point.
You may use one of these, you may use several, it is unlikely you will use all of them. Use your judgement and don't overwhelm the user.