create-diagram

create-diagram is a skill for Claude Code from Mertcikla/tld. It costs 57 tokens per session (1,190 once invoked), scanned A, original, Apache-2.0.

A skill for making navigable architecture diagrams from a codebase or a description of a software system. The diagrams show systems, services, modules, databases, users, and the connections between them, with broader views that can open into more detail.

In plain words
What is it for?
Use it to map a repository, service, multi-service application, or component dependencies. It can create high-level architecture views and drill-down diagrams for individual subsystems.
Why use it?
It helps explain how unfamiliar software is organized without relying on prose alone. It also makes relationships and data flows easier to inspect at different levels.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the tldiagram plugin — 1 skill shipped together

Good fit Use it to map a repository, service, multi-service application, or component dependencies. It can create high-level architecture views and drill-down diagrams for individual subsystems.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/mertcikla/tld/create-diagram
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Mertcikla/tld --skill create-diagram
Clone the repo
git clone --depth 1 https://github.com/Mertcikla/tld

Made for: Claude Code.

Or install tldiagram, the plugin that ships this one along with the rest of its 1 skill.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for create-diagram

README.md
[![agentmods](https://agentmods.dev/badge/skills/mertcikla/tld/create-diagram/github.svg)](https://agentmods.dev/skills/mertcikla/tld/create-diagram)
Your own site
<a href="https://agentmods.dev/skills/mertcikla/tld/create-diagram"><img src="https://agentmods.dev/badge/skills/mertcikla/tld/create-diagram/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for create-diagram

Your own site · 80×15
<a href="https://agentmods.dev/skills/mertcikla/tld/create-diagram"><img src="https://agentmods.dev/badge/skills/mertcikla/tld/create-diagram.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 57 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,190 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00057 $0.01190
Opus 5.5 $0.00023 $0.00476
Sonnet 5.5 $0.00011 $0.00238
Haiku 4.5 $0.00006 $0.00119

Measured 10d ago against content hash ab596de74e9b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

create-diagram scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/create-diagram/SKILL.md · 72 lines

How it starts

The opening of the file, as written. The whole thing — 72 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Create and Maintain Diagrams

Create a navigable architecture map that answers the user's questions. Keep useful existing content and stable refs when revising it.

Scope and evidence

Read the relevant source and inventory responsibilities, execution/data paths, callers, and dependencies. Connectors must have source evidence or support from the user's system description. Put source anchors in element links (file_path: path#symbol or a folder) and useful evidence in connector descriptions. Distinguish inferred relationships from confirmed behavior.

Choose overview and drill-down boundaries by responsibility. Keep each view readable, usually around 8–12 components. Avoid mirroring directories or expanding every class unless the requested questions need it. Do not add relationships just to eliminate warnings.

Select the destination

Reuse the current workspace or run tld init <project-dir> to create <project-dir>/.tld. Use tld context --format json to confirm the workspace and destination. Pin --workspace, --target, and any --data-dir consistently on previews, writes, and verification; use --target local for a local diagram.

For existing diagrams, inspect tld list views --tree, relevant elements/connectors, and tld inspect <ref> --format json before changing them. Use --source live for current target state. Prefer CLI mutations over editing cached YAML; apply deliberate YAML edits with tld sync.

Author by intent

Use command help for accepted fields and examples, tld import --schema for the exact offline document shape, and JSON output for returned refs/IDs.

  • Create a view for an existing element: tld view create runtime --name "Runtime". Create its owner with tld add first; adding children also creates the owner's view automatically.
  • Add or update a component: tld add "API" --ref api --parent runtime --kind service --link path#symbol.
  • Connect components: tld connect --view runtime --from api --to db --label "reads and writes". This creates the relationship without changing endpoint placements.
  • Show an unconnected component: tld view place runtime api. --from <old-view> moves its placement. Sharing may copy existing relationships; inspect live connectors afterward before adding or removing any.
  • Change metadata or a relationship: tld update element api description "Handles requests" or tld update connector <listed-key-or-id> label "queries".

Read the full file on GitHub · 72 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago Changed · -44 lines · +9 tokens per session ab596de74e9b
  2. 12d ago Changed · +2 lines 2b9292844815
  3. 1mo ago Changed · -13 lines 28ea4e379bd9
  4. 1mo ago Changed · -7 lines 2b9c5825c48c
  5. 1mo ago First seen · 134 lines · 48 tokens per session scan A 64367fe90de7

Subscribe to this mod's changes

create-diagram is a skill published in the GitHub repository Mertcikla/tld (294 stars, last pushed yesterday), licensed Apache-2.0. It adds 57 tokens to every session and 1,190 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

mermaid-skill

A tool for creating text-based Mermaid diagrams and exporting them as PNG, SVG, or PDF files. Mermaid is a format where diagram structure is written as text and laid out automatically.

Agents365-ai/mermaid-skill · 137 tokens

tldraw-skill

Use when user requests diagrams, flowcharts, architecture charts, or visualizations. Also use proactively when explaining systems with 3+ components, complex data flows, or relationships that benefit from visual representation. Generates .tldr JSON files and exports to PNG/SVG locally using @kitschpatrol/tldraw-cli.

Agents365-ai/tldraw-skill · 70 tokens

design-system-specification

Design a production-ready Design System and UI/UX visual style guide. Covers design tokens (colors, typography, spacing, shadows, radius), components (buttons, inputs, cards, tables, modals, navigation), layouts, interaction/hover states, iconography, motion design, responsive behavior, accessibility (WCAG 2.2), and…

fattain-naime/engineering-docs · 93 tokens

ux-flow-specification

Document the complete user experience of a product - information architecture, user journeys, screen-by-screen flows, and every UI state (loading, empty, error, success) - independent of visual styling. Use to define exactly how a user moves through a product before or alongside implementation, so navigation and…

fattain-naime/engineering-docs · 74 tokens

redesign-templates

Redesign the resume and cover letter templates into your own house style. Changes typography, palette, and layout while holding the ATS constraints fixed, then proves the result still compiles and still extracts. Run any time; not a pipeline stage.

VonTerraProject501c3/slushpile · 53 tokens

icon-composer-app-icon-workflow

Design, preview, validate, and integrate Apple app icons with Icon Composer. Use when a task mentions Icon Composer, .icon documents, Liquid Glass app icons, ictool preview exports, app icon design for iOS, iPadOS, macOS, or watchOS, or guided Icon Composer GUI work through Computer Use.

gaelic-ghost/socket · 73 tokens