Claude Code Skill

What it does

Ask Claude to "turn these ideas into a diagram" in any Claude Code session. The skill decides which of the four diagram types fits best, authors the structured source (markdown for mindmap, Mermaid for flowchart + sequence, IArchData JSON for architecture), calls the matching /public/<type>/image endpoint, and returns the image path. Raw mode means Claude owns the structure, so results are fast, cheap, and deterministic.

One install, four diagram types. Same auth token. Same skill triggers all of them.

Install

Download SKILL.md and scripts/render.sh into ~/.claude/skills/clipmind/, then set two environment variables. The render.sh script dispatches on --type to the right /public/<type>/image endpoint.

BASH
mkdir -p ~/.claude/skills/clipmind/scripts
curl -fsSL https://static.clipmind.tech/skills/clipmind/SKILL.md \
  -o ~/.claude/skills/clipmind/SKILL.md
curl -fsSL https://static.clipmind.tech/skills/clipmind/scripts/render.sh \
  -o ~/.claude/skills/clipmind/scripts/render.sh
chmod +x ~/.claude/skills/clipmind/scripts/render.sh

# then, one-time auth
export CLIPMIND_API_TOKEN='<paste the token from the API Docs page>'
export CLIPMIND_API_URL_BASE='https://api.clipmind.tech/public'

Usage

Once installed, any Claude Code session can trigger the skill. The skill picks the diagram type based on your prompt — explicit cues like "draw a flowchart" win; otherwise it routes by content shape (process → flowchart, system → architecture, interaction → sequence, anything else → mindmap).

TEXT
# in any Claude Code session, ask for whichever diagram fits:
> turn these notes into a mindmap:
>   - launch plan
>   - weeks 1-2: research
>   - weeks 3-4: design
>   - week 5: ship

> draw a flowchart for the JWT refresh token lifecycle

> show the architecture of a typical e-commerce backend
> with orders, catalog, payments, and a message queue

> sequence diagram for OAuth 2.0 authorization code flow

# Claude picks the type, authors the structured source
# (markdown / Mermaid / IArchData JSON), calls the matching
# /public/<type>/image endpoint in raw mode, and drops the
# PNG next to your prompt.

If you want to call the script directly (Claude does this for you under the hood):

BASH
# direct invocation (Claude does this for you, but here's the shape):
echo '# Photosynthesis
- Light reactions
- Calvin cycle' | ./scripts/render.sh --type mindmap --raw --out tree.png

cat <<'EOF' | ./scripts/render.sh --type flowchart --raw --out merge-sort.png
flowchart TD
  Start([Start]) --> Split{Length <= 1?}
  Split -->|Yes| Return([Return])
  Split -->|No| Recurse[Split + recurse]
  Recurse --> Merge[Merge halves]
  Merge --> Return
EOF

cat ecommerce.json | ./scripts/render.sh --type architecture --raw --out arch.png

cat <<'EOF' | ./scripts/render.sh --type sequence --raw --out oauth.png
sequenceDiagram
  participant User
  participant App
  participant Auth
  User->>App: Click login
  App->>Auth: GET /authorize
  Auth-->>App: code
  App->>Auth: POST /token
  Auth-->>App: access_token
EOF

Diagram types

Four types are routed through one --type flag. Pick the one that matches your content; the skill’s default heuristics handle ambiguous prompts.

All four accept the same theme tokens for the handdrawn family: classical, handdrawn, handdrawn-soft, handdrawn-sketch. The full layout / layoutTheme / theme tables below apply to mindmap only.

Mindmap presets

For mindmap specifically, the skill picks a sensible theme + layout per content type. Flowchart, architecture, and sequence use only the four shared handdrawn theme tokens (see above) — no separate layout / layoutTheme dimensions.

Mindmap option reference

Mindmap-specific tokens for layout / layoutTheme / theme. Flowchart, architecture, and sequence are layout-free; their only theme tokens are the four shared handdrawn variants. Full reference for every endpoint is in the API docs.

options.layout

options.layoutTheme

Only pair a layoutTheme with its own layout. Omit to get a sensible default.

options.theme

28 light themes plus a dark- prefixed variant for each (56 total).