Create Diagram

Costruisce un modello architetturale tld navigabile di una codebase tramite la CLI tld

di Mertcikla · Mertcikla/tld

Richiede configurazione ★ 9.2/10

Create Diagram — Costruisce un modello architetturale tld navigabile di una codebase tramite la CLI tld

Cosa fa

Costruisce un modello architetturale navigabile di una codebase locale o di un sistema descritto utilizzando la CLI tld — elementi, connettori etichettati e viste drill-down — e registra ogni comando in un log di esecuzione .tld/diagram.sh ri-eseguibile. Si attiva quando l'utente chiede di diagrammare un repo, mappare l'architettura di sistema, mostrare le relazioni tra i componenti o creare viste drill-down. Richiede l'installazione separata del binario tld (non è incluso nella skill).

Rapporto di test

Costruito il binario tld da sorgente (Go 1.26; aggiunto un placeholder frontend/dist per soddisfare una direttiva go:embed) poiché la CLI non è inclusa nella skill. Eseguito il workflow completo della skill in un repo mock a 3 livelli: tld init, quindi i comandi flat documentati (add --ref/--kind/--parent, connect --from/--to/--label) tramite un log di esecuzione .tld/diagram.sh, quindi tld validate e tld plan — tutti riusciti, producendo 6 elementi/6 connettori e evidenziando un avviso ARC102 missing-tech; tld tech suggest ha funzionato anche. Ogni forma CLI nel corpo corrispondeva alla realtà. Il baseline per lo stesso compito "diagram this system" era un blocco di testo statico Mermaid; l'output della skill è un grafo di conoscenza tld validato dalla macchina, pianificabile e drill-down — chiaramente più ricco. Il verdetto è setup, non pass, perché il binario tld deve essere installato separatamente (vendor curl|sh o una build da sorgente); copiare la skill da sola non fa nulla finché tld non è nel PATH.

Testato il: 2026-07-31 · Claude Code 2.x (agent harness)

Installazione

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).

Comandi e prompt di esempio

  • /create-diagramCostruisce un modello architetturale tld navigabile di una codebase tramite la CLI tld

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Diagram the architecture of this repository
  • Map the component relationships in this system
  • Create a drill-down view of this service