A skill for turning a product requirements document or technical specification into a documentation package describing the system's design. It can include diagrams, API definitions, architecture decisions, a glossary, and deployment information.

Use it to create architecture diagrams, data models, API descriptions, sequence or state diagrams, decision records, and related design documents.

It organizes technical decisions and system details into documentation that developers can review and maintain.

design — Skill for Claude Code by cryndoc

Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo

git clone --depth 1 https://github.com/cryndoc/polisade-orchestrator

agentmods

npx agentmods add skills/cryndoc/polisade-orchestrator/design

Made for: Claude Code.

Or install polisade, the plugin that ships this one along with the rest of its 25 skills, 2 commands.

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.

README.md

[![agentmods](https://agentmods.dev/badge/skills/cryndoc/polisade-orchestrator/design/github.svg)](https://agentmods.dev/skills/cryndoc/polisade-orchestrator/design)

Your own site

<a href="https://agentmods.dev/skills/cryndoc/polisade-orchestrator/design"><img src="https://agentmods.dev/badge/skills/cryndoc/polisade-orchestrator/design/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.

Your own site · 80×15

<a href="https://agentmods.dev/skills/cryndoc/polisade-orchestrator/design"><img src="https://agentmods.dev/badge/skills/cryndoc/polisade-orchestrator/design.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 162 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 20,775 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 warn 7 Sept 2026

SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

medium analysis-evasion · line 1
Suspicious Unicode normalization or mixed-script content

Fix: Review the flagged content for security risks. Ensure no credentials, secrets, or sensitive data are exposed.

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.

Model	Per session	Once invoked
Fable 5.1	$0.00162	$0.20775
Opus 5	$0.00081	$0.10387
Sonnet 5	$0.00032	$0.04155
Haiku 4.5	$0.00016	$0.02077

Measured yesterday against content hash b0fca4dfc9fd, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

design 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 yesterday.

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/design/SKILL.md · 1,470 lines

How it starts

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

/polisade:design [PRD-XXX | SPEC-XXX] — Doc-as-code design package через субагент

Создание набора doc-as-code артефактов (C4, sequence, ERD, OpenAPI, AsyncAPI, ADR, glossary, state, deployment) на основе PRD или SPEC. Все артефакты — Markdown с Mermaid/YAML, нативно рендерятся в GitHub/GitLab/Notion.

⚠️ DESIGN-NNN силосы — deprecated для brownfield (Pipeline V2 Ф4, WP4.3 / #221). Per-SPEC пакет DESIGN-NNN-<slug>/ (изолированный силос) на существующем корпусе устаревает: intent-подмножество (ADR, NFR/QAS, glossary, context-map, C4 L1, deployment) ведётся в едином живом корпусе docs/architecture/ (/polisade:design-corpus строит его best-effort с громкой пометкой INFERRED/GAP, а не молча выдаёт за проверенный), а derived (C4 L2/L3, ER, state, sequences) — регенерируется, руками не пишется. Разрез — docs/pipeline-v2/intent-derived-split.md. Greenfield-путь полного DESIGN (новый модуль с нуля) остаётся живым — deprecated значит «помечен и не развивается», не «удалён». Классификация силоса intent/derived (read-only отчёт) — scripts/polisade_migrate_design.py --report. Living-корпус — /polisade:design-corpus (experimental, за settings.experimental.designCorpus).

Силос → корпус. Живой корпус docs/architecture/ — источник правды по архитектуре. Пакет docs/architecture/DESIGN-NNN-<slug>/ — legacy-силос: сначала ищи факт в корпусе (model/, c4/, glossary/, quality/, flows/, contracts/, decisions/), и только если там его нет — читай силос. Прочитал силос — скажи вслух, отдельной строкой в выводе: ⚠️ переходное чтение силоса: <путь> (источник правды — корпус docs/architecture/). Молчаливое чтение силоса — дефект, а не экономия: PM не видит, что решение принято по устаревшему укладу. Если в пакете есть MIGRATED.md, его карта домов обязательна к прочтению, и читается она так: из силоса перестают читать ТОЛЬКО файлы таблицы «Перенесено 1:1» — они уже лежат в корпусе целиком. Файлы таблицы «Ещё НЕ в корпусе» не переносились: там назван целевой дом, которого ещё нет, и единственная копия факта — в силосе. Такой файл читают отсюда (громко), пока модель не свернула его в корпус; считать его устаревшим — потерять факт. Перевод силоса на корпус — ${POLISADE_PYTHON:-python3} scripts/polisade_migrate_silo.py <пакет> (dry-run по умолчанию, запись — явным --apply, конфликты — выбор человека, не скрипта).

⛔ Вызов скрипта отклонён или не запустился (Command references protected path / Install directory is read-protected / Filesystem Guard / the tool's default permission is 'deny', отказ песочницы, ненулевой exit без вывода) — STOP. Процитируй отказ дословно. НЕ пересказывай по исходнику, что скрипт «сделал бы»; НЕ собирай dry-run вручную; НЕ переходи к apply/push/pr-create. НЕ транскрибируй скрипт (прочитать → записать копию в /tmp или в проект → запустить копию): копия не байт-идентична — уезжают классы символов в regex, форма возврата функций, пропадают целые функции — и молча меняется набор применённых изменений. Отказ инструмента — это отказ, а не результат. Доложи PM дословный текст отказа и сошлись на #127 (доставка скриптов в проект).

⛔ Живой корпус docs/architecture/ пишет ОДИН исполнитель — ${POLISADE_PYTHON:-python3} {plugin_root}/scripts/polisade_corpus_io.py (stdlib-only). Ни Write, ни Edit, ни cp, ни mv, ни > в корпус не идут: примитив даёт пофайловую атомарность, блокировку от второго писателя, журнал оборванной промоции, проверяемый манифестом backup и отказ на симлинках и побегах пути. Ручное копирование обходит всё перечисленное — это регресс, а не «то же самое».

Хэш-контракт. Всё, что ты проверил ДО вызова, к моменту записи могло устареть, поэтому объявляй примитиву, каким ты ВИДЕЛ цель, — он сверит это сам, вплотную к записи: --expect-absent для нового файла (публикация идёт атомарным linkat, занятое имя отвергает ядро) и --expect-sha256 <hex> для правки существующего (ключ — из ПРОЧИТАННЫХ байтов, не из размера и не из даты); для promote — карта --expect-from <json> вида {путь: sha256|absent}. Отказ E-expect-* значит, что файл правил кто-то ещё: не повторяй с --force, покажи расхождение PM.

Исключение ровно одно, и оно названо, а не умолчано: legacy-силос docs/architecture/DESIGN-NNN-<slug>/ пишет /polisade:design своим Write-инструментом. Силос deprecated и переносится в корпус скриптом scripts/polisade_migrate_silo.py, а не развивается.

Read the full file on GitHub · 1,470 lines

Files

What ships with it

13 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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.

yesterday Changed · +171 lines b0fca4dfc9fd
9d ago First seen · 1,299 lines · 162 tokens per session scan A 120d7e392fe2

Subscribe to this mod's changes

design is a skill published in the GitHub repository cryndoc/polisade-orchestrator (7 stars, last pushed today), licensed Apache-2.0. It adds 162 tokens to every session and 20,775 once invoked, about $0.0008 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-31.

Autonomous Agents Claude Code Design and UX LLM ai-agents claude-code-plugin developer-tools

taiyi-ui-design

A design-planning guide for describing how an application's user interface should look and behave. It produces a UI-DESIGN.md document covering layouts, components, interactions, accessibility, and error states.

Dong90/oh-my-taiyiforge · 35 tokens

taiyi-diagram-arch

A workflow for turning written system or product architecture into readable, version-controlled diagrams using Mermaid or exported SVG and PNG files. Architecture diagrams show components, boundaries, data flows, and deployment relationships.

Dong90/oh-my-taiyiforge · 48 tokens

taiyi-restyle

A planning guide for breaking a large user-interface redesign into smaller, independently reviewable tasks. A user interface is the part of an application that people see and use.

Dong90/oh-my-taiyiforge · 39 tokens

taiyi-diagram-pipeline

A pipeline that creates and updates architecture diagrams in three stages: a C4 model from the code, an engineering architecture diagram, and an exported PNG image. C4 is a way to describe software architecture at several levels of detail.

Dong90/oh-my-taiyiforge · 52 tokens

taiyi-diagram-render

A tool for rendering existing C4 or architecture Mermaid diagrams as SVG or PNG images. C4 is a way to show software systems at different levels, while Mermaid is a text format for diagrams.

Dong90/oh-my-taiyiforge · 50 tokens

ui-animation

Builds, reviews, and measures UI motion, including springs, gestures, scroll effects, and curve fitting from recordings. Use when asked to "add animation", "match this easing", "reverse engineer this motion", or find animation opportunities. For action semantics use product-design; for visual layout use ui-design.

mblode/agent-skills · 65 tokens