ktg-plugin-marketplace/plugins/claude-design
2026-05-18 12:37:11 +02:00
..
.claude-plugin chore: roll up in-progress changes across plugins 2026-05-16 21:02:23 +02:00
skills/claude-design-facilitator feat(claude-design): add frontier-design preset (labelled experimental) 2026-05-18 12:28:06 +02:00
tests feat(claude-design): add SC2 coverage + SC3 citation tests 2026-05-18 12:33:38 +02:00
.coverage.md feat(claude-design): add .coverage.md preset manifest with evidence-grade labels 2026-05-18 12:29:25 +02:00
CHANGELOG.md chore: roll up in-progress changes across plugins 2026-05-16 21:02:23 +02:00
CLAUDE.md docs(claude-design): update CLAUDE.md with Scope fence + authoring rules 2026-05-18 12:37:11 +02:00
GOVERNANCE.md feat(claude-design): register in marketplace + LICENSE + GOVERNANCE scaffolding 2026-05-18 12:06:58 +02:00
LICENSE feat(claude-design): register in marketplace + LICENSE + GOVERNANCE scaffolding 2026-05-18 12:06:58 +02:00
README.md docs(claude-design): rewrite plugin README for v0.1 surface 2026-05-18 12:35:56 +02:00
verify.sh feat(claude-design): add verify.sh top-level roll-up 2026-05-18 12:34:24 +02:00

Claude Design Facilitator

End-to-end facilitator for prompting Claude Design (claude.ai/design). Walks the operator from raw idea through intent-preset selection, audience and destination clarification, DESIGN.md anchor, five-layer prompt drafting, copy-paste delivery, iteration coaching, and ship-readiness handoff. Cites Anthropic primary sources inline. Recommends Anthropic's official knowledge-work-plugins/design as the downstream post-design tool.

Solo-maintained, fork-and-own. This plugin is a starting point, not a vendor product. Issues are welcome as signals; pull requests are not accepted. See GOVERNANCE.md for the full model and what upstream provides.

AI-generated: all content produced by Claude Code through dialog-driven development. Full disclosure →

Version Platform Skill References Hooks Commands License

A Claude Code plugin that ships one skill (claude-design-facilitator) plus a reference tree for prompting Anthropic's claude.ai/design workspace. The skill auto-fires on natural-language triggers, walks the operator through an eight-phase facilitation flow, and produces a copy-paste-ready prompt grounded in Anthropic's verbatim Goal / Layout / Content / Audience framework and the four published per-preset prompt patterns. Output is the prompt — the artifact gets built in Claude Design.


Scope and complementarity

This plugin covers the pre-design and during-design lifecycle for claude.ai/design: idea → intent-preset selection → prompt engineering → copy-paste delivery → iteration coaching → ship-readiness check.

For post-design work — critique, accessibility audit, UX copy review, research synthesis, design-system audit, engineering handoff guidance — install Anthropic's official plugin:

claude plugins add knowledge-work-plugins/design

Anthropic's plugin operates on existing artifacts (Figma URLs, screenshots, copy snippets) and ships six slash-commands: /critique, /accessibility, /ux-copy, /research-synthesis, /design-system, /handoff. There is zero command overlap with this plugin and complementary lifecycle coverage — the two plugins are designed to be installed together. See skills/claude-design-facilitator/references/04-handoff-and-scope.md for the full coverage map.


What this plugin is NOT

By design, this plugin does not:

  • Drive the browser. No automation of claude.ai/design itself; you copy and paste the prompts the skill produces.
  • Generate the artifact code. Claude Design is the artifact generator. This plugin produces prompts that go into Claude Design.
  • Store artifact history or version artifacts. Claude Design has no version-tree primitive and this plugin does not invent one.
  • Cover adjacent Anthropic surfaces. Classic Artifacts at claude.ai, Live Artifacts in Claude Cowork, custom visuals embedded in a chat reply are out of scope — see skills/claude-design-facilitator/references/00-what-claude-design-is-and-isnt.md for the disambiguation reference.
  • Duplicate Anthropic's knowledge-work-plugins/design plugin. No /critique, no /accessibility, no /ux-copy, no /research-synthesis, no /design-system, no /handoff. The post-design lane belongs to Anthropic's plugin.

tests/validate-plugin.sh enforces the forbidden-command-name list mechanically.


Installation

Add the marketplace once, then install the plugin:

claude plugins marketplace add ktg-plugin-marketplace https://git.fromaitochitta.com/open/ktg-plugin-marketplace

In Claude Code:

/plugin install claude-design@ktg-plugin-marketplace

Or enable directly in ~/.claude/settings.json:

{
  "enabledPlugins": {
    "claude-design@ktg-plugin-marketplace": true
  }
}

The skill auto-discovers; no further configuration needed.


What you can do with it

The skill claude-design-facilitator walks the operator through eight phases. The phases are scoping + grounding (14), drafting + delivery (56), and iteration + ship-readiness (78).

Phase What happens
1. Disambiguate the surface Confirm claude.ai/design is the intended surface, not classic Artifacts, Live Artifacts, custom chat visuals, or knowledge-work-plugins/design. Read references/00 when signals are mixed.
2. Name the intent preset Pick one of eight Claude Design presets: designs, prototypes, slides, one-pagers, wireframes-mockups, pitch-decks, marketing-collateral, frontier-design. The per-preset reference file shapes the prompt pattern. Evidence-grade labels are surfaced.
3. Audience and destination Capture audience (internal team / external stakeholder / investor / customer) and destination (PDF / PPTX / HTML / Canva / Code-handoff / share-link). Flag PPTX-export traps for pitch-decks early.
4. Anchor on DESIGN.md Read references/02. If the operator has no DESIGN.md, point at the copy-paste brand-to-DESIGN.md extractor prompt.
5. Draft the prompt Compose layers 15 from references/01: Anthropic's verbatim Goal / Layout / Content / Audience framework + start-simple-layer-complexity + concrete-alternative-spec + propose-options-before-building + AI-slop negative constraints + four design dimensions + four grading criteria + the per-preset pattern.
6. Deliver Output a single copy-paste-ready fenced markdown code block. Add a one-line caption and three to five expected follow-up turns.
7. Iteration coaching Read references/03. Coach which surface to use next — Tweak panel (zero-token, surgical), inline comments (component-scoped), or chat (full regen). Session-break heuristics + recovery prompt library when iteration gets stuck.
8. Ship-readiness Run the export validation checklist. If shipping to engineering, confirm the Design → Code handoff bundle is complete. Recommend installing knowledge-work-plugins/design for downstream critique / accessibility / handoff.

The skill auto-fires on natural-language triggers like "I want to build a dashboard in Claude Design", "help me prompt claude.ai/design", "iterate on my Claude Design artifact". The full trigger list is in skills/claude-design-facilitator/.triggers.txt and tests/test-skill-triggers.sh validates each phrase appears in the skill description.

Explicit invocation works too: the skill registers as the slash command /claude-design-facilitator for when the operator wants to start a clean facilitation session.


Skill surface

Skill Triggers Output
claude-design-facilitator 12 natural-language phrases (full list in .triggers.txt); also explicit /claude-design-facilitator slash command A copy-paste-ready Claude Design prompt block composed from the five-layer stack and the per-preset pattern, with follow-up-turn expectations

No commands, no agents, no hooks, no MCP servers at v0.1. The single skill is the entire user-facing surface.


Reference content map

The plugin ships 13 reference files in skills/claude-design-facilitator/references/:

Foundation references (5):

  • 00-what-claude-design-is-and-isnt.md — Surface disambiguation against Artifacts, Live Artifacts, custom chat visuals, and Anthropic's knowledge-work-plugins/design.
  • 01-prompt-fundamentals.md — The five-layer prompt stack: GLCA framework + start-simple-layer-complexity + concrete-alternative-spec + propose-options + AI-slop negative constraints + four design dimensions + four grading criteria. Anchored on four Anthropic primary sources.
  • 02-design-md.md — DESIGN.md 9-section canonical structure + brand-to-DESIGN.md extractor prompt + failure modes.
  • 03-iteration-and-session.md — Tweak / Comment / Chat cascade, session economics, 4-screen inflection, recovery prompt library (break-default-aesthetic, fix-the-system, edit-previous-message, 3-failed-comment escalation, model downshift, verbal save-pattern).
  • 04-handoff-and-scope.md — Design → Code one-way handoff, bundle contents, lifecycle-stage coverage map vs Anthropic's knowledge-work-plugins/design, downstream tool recommendation.

Per-preset references (8):


Per-preset coverage

The canonical coverage manifest is .coverage.md. Below mirrors that file.

Preset Evidence grade Anthropic anchor
designs Anthropic-documented + community-validated launch post
prototypes Anthropic-documented + community-validated prototypes tutorial
slides Anthropic-documented + community-validated slides tutorial
one-pagers Community-only launch post
wireframes-mockups Community-only launch post
pitch-decks Community-only (with PPTX-export caveat) launch post
marketing-collateral Community-only launch post
frontier-design Experimental — no validated practitioner pattern launch post

When Anthropic publishes per-preset guidance for a Community-only or Experimental preset, .coverage.md and the affected preset file refresh — re-research triggers are documented inline.


Verification

bash plugins/claude-design/verify.sh

Runs five test scripts under tests/ in dependency order:

Script Verifies
validate-plugin.sh plugin.json + SKILL.md frontmatter + LICENSE + GOVERNANCE.md + README.md + CLAUDE.md + .coverage.md presence; forbidden-command-name scope-fence check; operator-private-context grep; Norwegian-leakage advisory
test-skill-triggers.sh SKILL.md description >=400 chars; every phrase in .triggers.txt appears in SKILL.md
test-sc2-artifact-coverage.sh Each preset in .coverage.md has >=1 file hit in plugin content
test-sc3-citations.sh No [CITE] / [verify] / "according to" placeholders; each Authoritative-claims file has >=1 Anthropic-domain URL
test-sc1-dogfood-log.sh Format-check the operator dogfood log in REMEMBER.md (gitignored) — 5 fields well-formed

Flags:

  • --strict — pass-through to test-sc1-dogfood-log.sh. Without --strict, missing dogfood block is advisory. With --strict, it is the release gate.
  • --quick — skip test-skill-triggers.sh for fast incremental runs.

Exit codes: 0 = all pass; non-zero = at least one sub-test failed.


Compatibility

Requirement Version
Claude Code Recent versions with plugin support
Anthropic surface claude.ai/design (Labs research preview launched 2026-04-17)
Platform macOS, Linux, Windows
Network None for the skill itself; the artifact-generation lives in claude.ai/design
Dependencies None — no npm packages, no Python, no external tools. Bash 3.2 compatible for test scripts.

Re-research triggers

The reference tree carries Anthropic citations that may decay. Re-research is triggered by:

  • Anthropic publishing per-preset guidance for a Community-only or Experimental preset
  • Anthropic announcing material changes to the Goal / Layout / Content / Audience framework, the AI-slop avoid-list, or the design grading criteria
  • Anthropic adding or removing an intent preset from the launch enumeration
  • A first verified frontier-design practitioner artifact shipping publicly
  • Anthropic's knowledge-work-plugins/design plugin adding or removing slash-commands (scope-fence implications)
  • Labs → GA URL rename for claude.ai/design

When a trigger fires, run bash verify.sh --strict after the update to confirm SC2 and SC3 still pass.


License

MIT. Fork it, modify it, ship your own version under your own name.