plantuml-syntax

tractorjuice/arc-kitCloud & DevOpsFrontend & design

plantuml-syntax is a skill in tractorjuice/arc-kit, last changed 1 Oct 2026. It can name web addresses and pre-approve tools.

From the author
PlantUML syntax reference, C4-PlantUML first, for writing or fixing a diagram in an artefact: sequence, class, activity, state, ER, component, deployment and use-case diagrams, skinparams and themes, C4 layout conflicts and rendering errors. Not needed for Mermaid (mermaid-syntax), or when the request is for a governed diagram artefact with document control, which /arckit:diagram produces.

At a glance

What it can touch

How much a skill can do, not whether it is risky.

Pattern check

Nothing flagged

That isn't proof the skill is harmless.

Commit 98167b9 · 20 Nov 2026

How the check works

Pattern check: nothing flagged

That isn't proof the skill is harmless.

QAI Index

56/QI

We rate every listed skill the same way, from 0 to 100.

A guide to compare by, not a verdict on the skill.

How it's scored

How the QAI Index is scored

Adoption · up to 40
GitHub stars on the repo that holds the skill, shared among its skills, and copies of the skill in other repos.
Quality · up to 30
Our pattern check, the format check, a named licence and a description of a sentence or more.
Upkeep · up to 20
How recently the skill's folder changed.
Trust · up to 10
An official collection, or an organisation that has confirmed its domain with GitHub.

Get an email when its check changes.

Keep it with the other skills you use, installed with one command.

Install

Sign in to see how to install it

Free with Google or an email link, no password needed. Then pick your agent and copy its steps.

Licence not identified
Licence
2.3k
Repo stars
Publisher

What it can touch

Sign in to see the file and line behind each one

The summary at the top stays open to everyone. Signing in is free, with Google or an email link.

Pattern check

Pattern check: nothing flagged · commit 98167b9 · 20 Nov 2026

We checked every text file in this skill, at commit 98167b9 on 20 Nov 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.

How the check worksReport an incorrect finding

  • https://github.com/SpillwaveSolutions/plantuml
  • https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
  • https://github.com/plantuml-stdlib/C4-PlantUML
  • https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml
  • https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Component.puml
  • https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Deployment.puml
  • https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Dynamic.puml
  • https://www.plantuml.com/plantuml/uml/

Format check

Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.

  • Agent Skills specPasses with warnings

    The format our Agent Skills docs set out, held to the strictest version of each rule among the agents we check.

    • Warning

      Fields outside the spec: paths (read by Claude Code). Uploads to the Claude apps and API, and strict validators, reject the file; most agents ignore these fields. O1

      Fix: Delete them for a portable skill, or keep them if you only target the agents that read them.

    • Warning

      allowed-tools is a list; the spec defines a space-separated string. gh skill publish rejects a list, though Claude Code accepts one. O5

      Fix: Write it on one line: allowed-tools: Read(/${CLAUDE_PLUGIN_ROOT}/**)

    • Warning

      Paths that may not work once the skill is installed: line 54: ../mermaid-syntax/references/c4-layout-science.md (outside the skill folder). B6

      Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.

    • Note

      There is no license field, so readers can't tell whether they may reuse the skill. O2

      Fix: Add license: with an SPDX name such as MIT or Apache-2.0, or the name of a bundled licence file.

    • Note

      Reference files over 100 lines with no table of contents at the top: references/activity-diagrams.md (276 lines), references/c4-plantuml.md (367 lines), references/class-diagrams.md (247 lines), references/component-diagrams.md (235 lines), references/deployment-diagrams.md (111 lines) and 5 more. B5

      Fix: Add a short list of the sections at the top of each.

  • Claude CodePasses with warnings

    Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.

    • Warning

      Paths that may not work once the skill is installed: line 54: ../mermaid-syntax/references/c4-layout-science.md (outside the skill folder). B6

      Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.

    • Note

      Reference files over 100 lines with no table of contents at the top: references/activity-diagrams.md (276 lines), references/c4-plantuml.md (367 lines), references/class-diagrams.md (247 lines), references/component-diagrams.md (235 lines), references/deployment-diagrams.md (111 lines) and 5 more. B5

      Fix: Add a short list of the sections at the top of each.

  • Claude apps & API uploadFails

    Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.

    • Error

      Upload and packaging fail on fields outside the spec: paths. O1

      Fix: Delete them, and keep your own data under metadata as text values.

    • Warning

      Paths that may not work once the skill is installed: line 54: ../mermaid-syntax/references/c4-layout-science.md (outside the skill folder). B6

      Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.

    • Note

      The description is 392 characters. The claude.ai Help Center says 200 at most, though Anthropic's API docs and validator allow 1,024. D4

      Fix: If the claude.ai upload refuses it, trim the description to 200 characters.

    • Note

      allowed-tools is a list; the spec defines a space-separated string. O5

      Fix: Write it on one line: allowed-tools: Read(/${CLAUDE_PLUGIN_ROOT}/**)

    • Note

      Reference files over 100 lines with no table of contents at the top: references/activity-diagrams.md (276 lines), references/c4-plantuml.md (367 lines), references/class-diagrams.md (247 lines), references/component-diagrams.md (235 lines), references/deployment-diagrams.md (111 lines) and 5 more. B5

      Fix: Add a short list of the sections at the top of each.

  • OpenAI (Codex & API)Passes with warnings

    Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.

    • Warning

      Fields outside the spec: paths. Codex ignores them; OpenAI doesn't say whether its upload accepts them. O1

      Fix: Delete them, or move your own data under metadata as text values.

    • Warning

      Paths that may not work once the skill is installed: line 54: ../mermaid-syntax/references/c4-layout-science.md (outside the skill folder). B6

      Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.

    • Note

      allowed-tools is a list; the spec defines a space-separated string. O5

      Fix: Write it on one line: allowed-tools: Read(/${CLAUDE_PLUGIN_ROOT}/**)

  • VS Code & CopilotPasses with warnings

    VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.

    • Warning

      Paths that may not work once the skill is installed: line 54: ../mermaid-syntax/references/c4-layout-science.md (outside the skill folder). B6

      Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.

    • Note

      VS Code ignores fields it doesn't support: paths. O1

      Fix: Delete them unless another agent you target reads them.

    • Note

      allowed-tools is a list; the spec defines a space-separated string. O5

      Fix: Write it on one line: allowed-tools: Read(/${CLAUDE_PLUGIN_ROOT}/**)

SKILL.md

We only show SKILL.md text here when its licence clearly allows it.

Read SKILL.md on GitHub (opens in a new tab)

Files

Changelog

Newest first: each commit that changed its folder on GitHub, and each change to its listing here.

  1. Listed on QAI
  2. Updated: fix: no hook approves anything; commands pre-approve their own file r… (d8b3a99 (opens in a new tab))
  3. Updated: feat: rewrite core skill descriptions in request-class style (f2217c7 (opens in a new tab))
  4. Updated: refactor: move the 11 Claude Code plugins under plugins/ (#585) (37ae108 (opens in a new tab))

QAI Index badge

Show this skill's QAI Index in a README or on a website. It links back to this page and changes when we refresh the catalog.

Preview of the QAI Index badge
[![QAI Index](https://qai.io/badge/skills/tractorjuice/arc-kit/plantuml-syntax.svg)](https://qai.io/skills/tractorjuice/arc-kit/plantuml-syntax)

More from tractorjuice/arc-kit

SkillQAI IndexWhat it can touchPattern checkLicenceUpdated
59/QI
  • Pre-approves tools
Pattern check: Nothing flaggedNo licence11 Nov 2026
60/QI
  • Installs more skills
  • Runs shell commands
  • +2 more
Pattern check: Nothing flaggedNo licence19 Nov 2026
47/QI
  • Names web addresses
Pattern check: 1 item to reviewNo licence7 Oct 2026
47/QI
  • Names web addresses
Pattern check: 1 item to reviewNo licence7 Oct 2026
47/QI
  • Names web addresses
Pattern check: 1 item to reviewNo licence7 Oct 2026
47/QI
  • Names web addresses
Pattern check: 1 item to reviewNo licence7 Oct 2026
All skills in tractorjuice/arc-kit

Other Cloud & DevOps skills

Same category, most repo stars first.

SkillQAI IndexWhat it can touchPattern checkLicenceUpdated
75/QI
  • Downloads software
  • Runs shell commands
  • +2 more
Pattern check: Nothing flaggedMIT20 Nov 2026
78/QI
  • Reaches the network
  • Names web addresses
Pattern check: Nothing flaggedMIT1 Nov 2026
78/QI
  • Instructions only
Pattern check: Nothing flaggedMIT5 Nov 2026
canaryPost-deploy canary monitoring. Use for: monitor after deploy, canary check. (gstack)

garrytan/gstack

70/QI
  • Runs shell commands
  • +3 more

Pattern check: 3 items to reviewMITUpdated 19 Nov 2026

70/QI
  • Runs shell commands
  • Reaches the network
  • +2 more
Pattern check: 3 items to reviewMIT19 Nov 2026
gstack-reviewUse before merging a branch or PR: review the diff for bugs that pass CI but break production, fix the obvious ones and ask about the rest. (gstack)

garrytan/gstack

79/QI
  • Runs shell commands
  • +2 more

RemovedPattern check: Nothing flaggedMITUpdated 5 Nov 2026

79/QI
  • Runs shell commands
  • Reaches the network
  • +1 more
Removed Pattern check: Nothing flaggedMIT5 Nov 2026
80/QI
  • Instructions only
Pattern check: Nothing flaggedMIT15 Nov 2026

Repo facts from GitHub on 20 Nov 2026. Files read at commit 98167b9.

QAI did not write these skills and is not affiliated with their authors unless a page says so. Logos and icons belong to their owners and are not a mark of approval. How we check