IcePanel plugin

Claude Code and GitHub Copilot skills for working with IcePanel architecture landscapes.

The repository keeps the canonical Claude skill source under skills/ and includes the harness-specific manifests and skill copies required by GitHub Copilot discovery.

/plugin marketplace add IcePanel/icepanel-plugin
/plugin install icepanel@icepanel-plugins

To try it from a local clone instead, point the marketplace at the checkout:

/plugin marketplace add ./icepanel-plugin
/plugin install icepanel@icepanel-plugins

If the install summary says Run /reload-plugins to activate., run that too.

The repository includes a GitHub Copilot CLI plugin manifest at plugin.json and a marketplace catalog at .github/plugin/marketplace.json. The Copilot app and other project-integrated surfaces discover skills from .github/skills/:

.github/skills/creating-c4-diagrams/
.github/skills/importing-structurizr-dsl/
.github/skills/importing-mermaid-c4/
.github/skills/translating-context-maps/

The canonical skill source remains under skills/ for the Claude plugin and CLI plugin. The .github/skills/ copies are required because GitHub Copilot uses that documented project-skill location.

Builds and maintains C4 models in IcePanel through its REST API: model objects (actors, systems, apps, stores, components), connections, catalog technologies and icons, and Level 1/2/3 diagrams with hand-authored layout.

It covers the parts that are easy to get wrong: that the model matters more than the diagrams, that a diagram is a story rather than a dump of every edge, that IcePanel has no auto-layout so placement is the whole job, and the places the published API docs disagree with the API.

Includes a helper script for the mechanical work:

python scripts/icepanel.py import  <landscapeId> model.json   # upsert objects and connections
python scripts/icepanel.py idmap   <landscapeId>              # map import IDs to IcePanel IDs
python scripts/icepanel.py diagram <landscapeId> l2.json      # create a diagram from a layout spec
python scripts/icepanel.py verify  <landscapeId>              # check every diagram for layout problems

Turns a Structurizr DSL workspace into IcePanel model objects, connections and diagrams. Structurizr is already model-first, so this is a translation rather than a reconstruction: the model block becomes the model, the views block becomes the diagrams.

What is left is inference, and each call is confirmed with you before anything is written. Structurizr has one container type where IcePanel has two, no external flag, no software system above an infrastructureNode, and no layout to preserve.

It reads a file, a directory (resolving !include), a URL or a pasted block, and never executes !script or !plugin. It stops at a validated import file and diagram specs, then hands off to creating-c4-diagrams.

Includes a helper script for the mechanical work:

python scripts/structurizr_dsl.py parse workspace.dsl --out structurizr

Turns Mermaid C4 diagrams (C4Context, C4Container, C4Component, C4Dynamic, C4Deployment) into IcePanel model objects, connections, and diagrams. It reconstructs the model from one or more blocks, where aliases are the merge key, then confirms inferences with you before anything is written.

It stops at a validated import file and diagram specs, then hands off to creating-c4-diagrams for import, drawing, and verification.

Includes a helper script for the mechanical work:

python scripts/mermaid_c4.py parse docs/architecture.md --out mermaid-c4

Turns an image or sketch of a DDD context map into IcePanel model objects and connections. Bounded contexts become a group with a system inside it, upstream/downstream relationships become connections, and the context map patterns (OHS, PL, CF, ACL, SK, C/S, Partnership) become tags on those connections.

It stops at the import file and hands off to creating-c4-diagrams, which does the importing and diagramming.

• An IcePanel API key, generated in the organization's settings on the API keys page. Format is <key-id>:<secret>.

  export ICEPANEL_TOKEN='<key-id>:<secret>'

• Python 3 and curl. The script shells out to curl on purpose: Python installs on macOS often lack a configured CA bundle, which fails with CERTIFICATE_VERIFY_FAILED against the API.

.claude-plugin/marketplace.json          the marketplace catalog
.claude-plugin/plugin.json               the plugin manifest
.github/plugin/marketplace.json          the GitHub Copilot marketplace catalog
plugin.json                              the GitHub Copilot CLI plugin manifest
skills/
  creating-c4-diagrams/
    SKILL.md
    references/api.md                    endpoints, schemas, enums, doc corrections
    references/layout.md                 grid, boundaries, line routing, spec format
    references/example.md                a worked three-level build
    scripts/icepanel.py
  importing-structurizr-dsl/
    SKILL.md
    references/mapping.md                element, group, relationship and view mapping
    references/syntax.md                 the Structurizr DSL the parser accepts
    references/example.md                a worked import of the Big Bank plc workspace
    scripts/structurizr_dsl.py
  importing-mermaid-c4/
    SKILL.md
    references/mapping.md                element, boundary and relationship mapping
    references/syntax.md                 the Mermaid C4 syntax the parser accepts
    references/example.md                a worked import: two blocks to commands
    scripts/mermaid_c4.py
  translating-context-maps/
    SKILL.md
    references/notation.md               the ddd-crew symbol set, and how sketches mislead
    references/example.md                a worked translation, map to import file
.github/skills/                            GitHub Copilot app/project skills

Licensed under the MIT License.