New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Spk Practice Show Me

by spec-kitty in spec-kitty/spec-kitty

Explain Spec Kitty work with compact, checkable visuals. An agent skill from spec-kitty/spec-kitty.

MITAuto-check passedDevelopment

Install Spk Practice Show Me

skills CLI
$ npx skills add spec-kitty/spec-kitty --skill spk-practice-show-me -a claude-code

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

GitHub CLI
$ gh skill install spec-kitty/spec-kitty spk-practice-show-me --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/spec-kitty/spec-kitty.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/charter/offering/skills/spk-practice-show-me .claude/skills/spk-practice-show-me && 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
spk-practice-show-me
GitHub stars
1.7k
Token cost
~944 tokens
SKILL.md length
421 words
Files
7 (incl. references, assets)
Skills in repo
45
Repo updated
First seen
Licence
MIT

At a glance

Explain Spec Kitty work with compact, checkable visuals. An agent skill from spec-kitty/spec-kitty.

  • Whenever prose obscures structure
  • SKILL.md covers Choose the Shape, Load Spec Kitty's Diagram…, Render /spec-kitty.status in a… and Origin and Attribution
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Diagrams

What it does

Spk Practice Show Me is an agent skill from spec-kitty/spec-kitty. Explain Spec Kitty work with compact, checkable visuals. Use for specs, plans, architecture, control flow, diffs, status boards, or whenever prose obscures structure.

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files and assets (for example `assets/MERMAID_DIAGRAMMING.md`, `assets/PLANTUML_DIAGRAMMING.md` and `assets/mermaid-theme-bluegray-conversation-template.md`).

It sits in Development, covering Diagrams. The repository describes itself as: Spec-Driven Development with organizational governance. Specs tell AI agents what to build; Charter governs how they build it. Git-native missions, enforceable workflows, and… The licence is MIT.

When your agent uses it

  • Whenever prose obscures structure
  • Tasks that involve Diagrams

Example prompts

  • “/spk-practice-show-me”

What it can do on your machine

Read from SKILL.md and the folder at commit d12146f. 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 (its code samples are bash).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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

Spk Practice Show Me loads about 944 tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 421 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~944
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.8k

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

The full file from spec-kitty/spec-kitty at commit d12146f, republished under its MIT licence (© spec-kitty). 421 words, ~944 tokens.

Download SKILL.mdSave it as .claude/skills/spk-practice-show-me/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
spk-practice-show-me
description
Explain Spec Kitty work with compact, checkable visuals. Use for specs, plans, architecture, control flow, diffs, status boards, or whenever prose obscures structure.

spk-practice-show-me

Make the current point visible. Skip the preamble, keep prose brief, and pick the smallest representation that answers the question. Do not add a diagram when a sentence or short list is clearer.

Choose the Shape

  • Logic or an algorithm: compact pseudocode.
  • Runtime behavior: call tree or sequence diagram.
  • UI composition: component tree with only relevant state and boundaries.
  • Ownership or refactor scope: shallow file tree with one responsibility per entry.
  • Existing-to-proposed change: diff over the matching tree, flow, or pseudocode.
  • Domain lifecycle: state diagram.
  • Data or concept relationships: entity-relationship or class diagram.
  • Architecture: C4 Context first, then Container or Component only when useful.
  • Dense visual UI/layout comparison: one focused HTML artifact when the host can open it; keep durable project documentation diagram-as-code.

Place each visual beside the text it supports. Include only the calls, files, states, relationships, and boundaries needed for the current decision. Label relationships and preserve source paths or identifiers that make the visual checkable against code and artifacts.

Load Spec Kitty's Diagram Doctrine

Prefer Mermaid inline; use PlantUML when richer layout, C4 support, or its DSL earns the rendering cost. Read references/spec-kitty-diagram-sources.md, then load only the needed toolguide, directive, or tactic through spec-kitty charter context --include .... It maps portable commands to the canonical Mermaid and PlantUML guides, C4 directive, diagram-review tactic, and bundled theme assets.

In specification, visualize actor flows, concepts, rules, and lifecycle states; do not smuggle implementation choices into product requirements. In planning, visualize architecture, data/control flow, boundaries, migrations, and risky interactions. Prose requirements and contracts remain authoritative.

Show full SKILL.md (166 more words)Show less

Render /spec-kitty.status in a TUI

Use the command's Rich human output in a capable terminal. For a custom TUI, consume structured data instead of scraping ANSI output:

bash
spec-kitty agent tasks status --json --mission <handle>

Keep lifecycle truth distinct from the current status display projection:

text
planned → claimed → in_progress → for_review → in_review → approved → done
Display: Planned → Doing → For Review → Approved → Done

For the five-group display only, fold claimed, in_progress, and in_review into Doing and mark claimed/review entries. Read blocked/canceled from work_packages[].lane, stale from work_packages[].is_stale, and review warnings from stalled_wps and stale_verdicts; show them off-board. On narrow screens, stack the same groups vertically.

Show Done progress (done_count / total_wps) separately from Weighted readiness (progress_percentage). Never label weighted readiness as completed work. JSON has no next_action: reproduce the human hint from mission_slug as spec-kitty next --agent <your-name> --mission <mission_slug>, with the caller supplying the agent. That command—not status—selects the exact workflow action.

Origin and Attribution

Adapted from HumanLayer's MIT-licensed show-me skill by Dexter Horthy: https://github.com/humanlayer/skills/tree/main/plugins/show-me/skills/show-me. The source article also credits Dillon Mulroy for the call-tree shape and Matt Pocock for HTML-explainer inspiration. Preserve the notice and provenance in references/humanlayer-origin-and-license.md when redistributing this skill.

© spec-kitty, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references, assets) in src/charter/offering/skills/spk-practice-show-me of spec-kitty/spec-kitty.

  • SKILL.md
  • assets/MERMAID_DIAGRAMMING.md
  • assets/PLANTUML_DIAGRAMMING.md
  • assets/mermaid-theme-bluegray-conversation-template.md
  • assets/mermaid-theme-common-template.md
  • references/humanlayer-origin-and-license.md
  • references/spec-kitty-diagram-sources.md

Open the folder on GitHubat commit d12146f

Compare with similar skills

Spk Practice Show Me 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.

Spk Practice Show Me compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spk Practice Show Me this skillspec-kitty/spec-kitty1.7k—~944Automated safety check: PassMIT
Archify Diagramstt-a1i/archify81k—~2.9kAutomated safety check: PassMIT
JSON Canvasheyitsnoah/claudesidian2.6k18 repos~3.5kAutomated safety check: PassMIT
Diagram Designcathrynlavery/diagram-design48k1 repos~7.6kAutomated safety check: PassMIT
Fireworks Tech Graphtisfeng/Easydict15k1 repos~1.4kAutomated safety check: PassMIT
Excalidraw Diagramcoleam00/excalidraw-diagram-skill5k2 repos~6.1kAutomated safety check: PassNone

Similar skills

  • Archify Diagrams

    tt-a1i/archify

    Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.

    81k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed

  • JSON Canvas

    heyitsnoah/claudesidian

    Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections.

    2.6k GitHub starsUsed in 18 repos~3.5k tokens
    DevelopmentAuto-check passed

  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    48k GitHub starsUsed in 1 repo~7.6k tokens
    DevelopmentAuto-check passed

  • Fireworks Tech Graph

    tisfeng/Easydict

    Create precise SVG technical diagrams, export PNG or offline HTML, and animate supported semantic SVGs to GIF.

    15k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed

  • Excalidraw Diagram

    coleam00/excalidraw-diagram-skill

    Create Excalidraw diagram JSON files that make visual arguments.

    5k GitHub starsUsed in 2 repos~6.1k tokens
    DevelopmentAuto-check passed

  • Draw.io Diagram Studio

    Agents365-ai/drawio-skill

    Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.

    10k GitHub stars~2.4k tokensUpdated 8 days ago
    DevelopmentAuto-check: notes

More from spec-kitty/spec-kitty

All 45 skills in this repo

  • Spec Kitty Setup Doctor

    spec-kitty/spec-kitty

    Install, verify, and recover the modern Spec Kitty 2.0.11+ operating surface.

    1.7k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

  • Spec Kitty Git Workflow

    spec-kitty/spec-kitty

    Understand how Spec Kitty manages git: what git operations Python handles automatically, what agents must do manually, worktree lifecycle, auto-commit behavior, merge execution, and the safe-commit…

    1.7k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

  • Spec Kitty Mission System

    spec-kitty/spec-kitty

    Understand how Spec Kitty missions work: the 4 built-in mission types, how they define workflows via step contracts and action indices, how missions and work packages relate, how templates are…

    1.7k GitHub stars~4.4k tokensUpdated today
    Auto-check passed

  • Spec Kitty Orchestrator API Operator

    spec-kitty/spec-kitty

    Teach agents and external systems how to use spec-kitty orchestrator-api to drive workflows from outside the host CLI.

    1.7k GitHub stars~3k tokensUpdated today
    Auto-check passed

  • Spec Kitty Runtime Review

    spec-kitty/spec-kitty

    Review runtime-owned outputs using the Spec Kitty review workflow surface, then direct approval or rejection with structured feedback.

    1.7k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

  • Spk Charter Governance

    spec-kitty/spec-kitty

    Run Spec Kitty charter interview, generation, context loading, and synchronization workflows for project governance.

    1.7k GitHub stars~654 tokensUpdated today
    Auto-check passed

Categories

Questions about Spk Practice Show Me

What does Spk Practice Show Me do?

Explain Spec Kitty work with compact, checkable visuals. An agent skill from spec-kitty/spec-kitty. Spk Practice Show Me is an agent skill from spec-kitty/spec-kitty. Explain Spec Kitty work with compact, checkable visuals.

When should I use Spk Practice Show Me?

Spk Practice Show Me fits situations like: whenever prose obscures structure; tasks that involve Diagrams.

How do I install Spk Practice Show Me in Claude Code?

Run `npx skills add spec-kitty/spec-kitty --skill spk-practice-show-me -a claude-code`. Or copy the skill folder (src/charter/offering/skills/spk-practice-show-me in spec-kitty/spec-kitty) into .claude/skills/spk-practice-show-me in your project. Claude Code loads it when a task matches its description.

How do I install Spk Practice Show Me in Codex?

Run `npx skills add spec-kitty/spec-kitty --skill spk-practice-show-me -a codex`. Or copy the skill folder (src/charter/offering/skills/spk-practice-show-me in spec-kitty/spec-kitty) into .agents/skills/spk-practice-show-me in your project. Codex loads it when a task matches its description.

Can I use Spk Practice Show Me 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 spec-kitty/spec-kitty --skill spk-practice-show-me -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spk-practice-show-me, .gemini/skills/spk-practice-show-me, .github/skills/spk-practice-show-me and .opencode/skills/spk-practice-show-me in your project.

What does Spk Practice Show Me need to run?

SKILL.md names no scripts, command-line tools or credentials: Spk Practice Show Me is instructions for the agent only.

Does Spk Practice Show Me access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Spk Practice Show Me 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 Spk Practice Show Me use?

Spk Practice Show Me is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Spk Practice Show Me use?

About 944 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 820 tokens, read only when the agent opens those files.

What are the alternatives to Spk Practice Show Me?

Skills that share tags, products or a category with Spk Practice Show Me: Archify Diagrams (tt-a1i/archify, 81k stars), JSON Canvas (heyitsnoah/claudesidian, 2.6k stars), Diagram Design (cathrynlavery/diagram-design, 48k stars) and Fireworks Tech Graph (tisfeng/Easydict, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spk Practice Show Me?

spec-kitty (a GitHub organization) maintains it in spec-kitty/spec-kitty, which has 1,678 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on October 10, 2026.

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