Create Diagram
Build a navigable tld architecture model of a codebase via the tld CLI
Test report
- Verdict
- Works with setup
- Score
- Tested
- Jul 31, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · 4e1d449
Built the tld binary from source (Go 1.26; added a frontend/dist placeholder to satisfy a go:embed directive) since the CLI isn't bundled with the skill. Ran the skill's full workflow in a mock 3-tier repo: tld init, then the documented flat commands (add --ref/--kind/--parent, connect --from/--to/--label) via a .tld/diagram.sh execution log, then tld validate and tld plan — all succeeded, yielding 6 elements/6 connectors and surfacing an ARC102 missing-tech warning; tld tech suggest also worked. Every CLI shape in the body matched reality. Baseline for the same "diagram this system" task was a static Mermaid text block; the skill's output is a machine-validated, plannable, drill-down tld knowledge graph — clearly richer. Verdict is setup, not pass, because the tld binary must be installed separately (vendor curl|sh or a source build); copying the skill alone does nothing until tld is on PATH.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 5/5
- Triggers reliably 5/5
- Output vs. baseline 8/10
- Docs & honesty 5/5
What Create Diagram does
Builds a navigable architecture model of a local codebase or described system using the tld CLI — elements, labeled connectors, and drill-down views — and records every command in a re-runnable .tld/diagram.sh execution log. Triggers when the user asks to diagram a repo, map system architecture, show component relationships, or create drill-down views. Requires the tld binary installed separately (it is not bundled with the skill).
How to install Create Diagram
git clone --depth 1 https://github.com/Mertcikla/tld.git /tmp/create-diagram-src
mkdir -p ~/.claude/skills
cp -R /tmp/create-diagram-src/skills/create-diagram ~/.claude/skills/create-diagram
# REQUIRES the `tld` binary on PATH (NOT bundled). Official installer (macOS/Linux):
# curl -LsSf https://tldiagram.com/install.sh | sh
# Windows: powershell -ExecutionPolicy ByPass -c "irm https://tldiagram.com/install.ps1 | iex"
# Or build from source (needs Go 1.26+; go:embed needs a frontend/dist placeholder):
# cd /tmp/create-diagram-src && mkdir -p frontend/dist && echo x > frontend/dist/index.html \
# && go build -o /usr/local/bin/tld ./cmd/tld
# Plugin-marketplace alternative: repo is a Claude plugin (.claude-plugin/plugin.json + .agents/plugins/marketplace.json).
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Create Diagram
-
/create-diagramBuild a navigable tld architecture model of a codebase via the tld CLI
It also activates on plain-language prompts like these:
-
Diagram the architecture of this repository -
Map the component relationships in this system -
Create a drill-down view of this service
Frequently asked questions
- Is the Create Diagram skill free?
- Yes. The skill itself is free from Mertcikla/tld. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Create Diagram work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 31, 2026. Verdict: Works with setup. Built the tld binary from source (Go 1.26; added a frontend/dist placeholder to satisfy a go:embed directive) since the CLI isn't bundled with the skill. Ran the skill's full workflow in a mock 3-tier repo: tld init, then the documented flat commands (add --ref/--kind/--parent, connect --from/--to/--label) via a .tld/diagram.sh execution log, then tld validate and tld plan — all succeeded, yielding 6 elements/6 connectors and surfacing an ARC102 missing-tech warning; tld tech suggest also worked. Every CLI shape in the body matched reality. Baseline for the same "diagram this system" task was a static Mermaid text block; the skill's output is a machine-validated, plannable, drill-down tld knowledge graph — clearly richer. Verdict is setup, not pass, because the tld binary must be installed separately (vendor curl|sh or a source build); copying the skill alone does nothing until tld is on PATH.
- What is the Create Diagram SkillProof Score?
- 9.2/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 8/10, docs & honesty 5/5.
- How do I install Create Diagram?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Create Diagram with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.