create-diagram

create-diagram is a skill for Claude Code from Mertcikla/tld. It costs 48 tokens per session (1,502 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 48 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,502 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.00048 $0.01502
Opus 5 $0.00024 $0.00751
Sonnet 5 $0.00010 $0.00300
Haiku 4.5 $0.00005 $0.00150

Measured 9d ago against content hash 64367fe90de7, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, 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 9d 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 · 134 lines

How it starts

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

Create Diagram

Build a tld workspace that helps someone understand a system by moving from broad architecture to useful detail.

When to Use

  • The user asks for a diagram, architecture map, component map, dependency map, or data-flow view.
  • The target is a local codebase, service, package, multi-service app, or described system.
  • The useful output is a navigable tld model rather than prose alone.

When NOT to Use

  • The user only wants code explanation and did not ask for a visual model.
  • The task is to change application behavior.
  • The diagram is unrelated to software/system structure and does not benefit from tld's hierarchy.

tld Mental Model

tld models architecture as a hierarchy of elements and connectors.

  • An element is the node in the knowledge graph. It can represent a system, subsystem, service, module, class, database, external system, user, or any other entity relevant to the architecture.
  • A view is the canvas inside an element. Add children with --parent <ref> to create drill-downs. There is no separate "create view" command. View is used to group related elements, or to explain a subsystem in more detail.
  • A connector is the edges of the graph, describes a relationship between elements. The view is inferred from the elements' shared parent.
  • A kind is a broad role such as system, container, component, database, external system, or person omit if it doesn't fit any clear category.
  • A technology is metadata. Prefer catalog names suggested by tld tech suggest.

The goal is not to mirror folders. Build a navigable map of how control, data, ownership, and dependencies move through the system.

CLI Basics

Use the flat CLI shape:

tld add "<name>" --ref <ref> --kind <kind> --parent <parent-ref>
tld connect --from <source-ref> --to <target-ref> --label "<specific interaction>"
tld validate

For root-level elements, omit --parent.

If a technology label is uncertain, check it first:

Read the full file on GitHub · 134 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. 9d 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 (284 stars, last pushed yesterday), licensed Apache-2.0. It adds 48 tokens to every session and 1,502 once invoked, about $0.0002 per session on Opus 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

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

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