design

design is a skill for Claude Code, Codex from scolladon/craft. It costs 25 tokens per session (437 once invoked), scanned A, original, MIT.

A design phase in a structured software-development workflow that produces a feature design document and decision options for an architecture decision record, or ADR.

In plain words
What is it for?
Use it to investigate a repository, read requirements, create or update design documents, and prepare decisions for an ADR discussion.
Why use it?
It helps turn requirements into a documented design before implementation and records important technical choices.

Skill for Claude CodeCodex

Installs and runs on its own, but its text points at files inside its plugin — anything it tells you to read at a ${CLAUDE_PLUGIN_ROOT} path is only there once the plugin is installed. Installing the plugin gets both.

Part of the craft plugin — 20 skills, 4 commands, 18 agents, 1 hook shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/scolladon/craft/design
Any agent
npx skills add scolladon/craft --skill design
Clone the repo
git clone --depth 1 https://github.com/scolladon/craft

Made for: Claude Code, Codex.

Or install craft, the plugin that ships this one along with the rest of its 20 skills, 4 commands, 18 agents, 1 hook.

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.

agentmods badge for design

README.md
[![agentmods](https://agentmods.dev/badge/skills/scolladon/craft/design.svg)](https://agentmods.dev/skills/scolladon/craft/design)
Your own site
<a href="https://agentmods.dev/skills/scolladon/craft/design"><img src="https://agentmods.dev/badge/skills/scolladon/craft/design.svg" alt="Measured on agentmods" height="20"></a>
Per session 25 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 437 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.

ModelPer sessionOnce invoked
Fable 5 $0.00025 $0.00437
Opus 5 $0.00013 $0.00218
Sonnet 5 $0.00005 $0.00087
Haiku 4.5 $0.00003 $0.00044

Measured 4d ago against content hash e58ad0226530, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 4d ago.

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 · 34 lines

What it actually says

craft:design

Preamble (always runs — non-overridable)

  1. manifest-lint.sh must pass (skip if the orchestrator already ran it this turn); read manifest. Standalone: scope defaults to the current branch vs the default branch; establish global-context preconditions against the current checkout root.
  2. Probe: design docs directory (paths.design, else docs/design/, create if absent); repo's own design template, else "${CRAFT_ROOT:-${CLAUDE_PLUGIN_ROOT}}/templates/design.md".
  3. If a requirements artifact was produced this run, treat it as a hard input (read it, design against it); else self-supply requirements in the design doc's own section.
  4. Intention consult surface (advisory). The phase receives the intention consult slice on slot 1 — the IntentionView entries whose subjects intersect this phase's change scope, prepended into the injected contract block alongside the memory hint (see skills/run/SKILL.md step 4). An empty slice means the phase probes as today.

Procedure (default body — a manifest override: replaces everything below)

  1. Spawn craft:designer with: the resolved brief; the absolute working directory; the output path <design-dir>/<slug>.md; the template; the commit message docs(design): <slug>; the manifest's global + design-phase context: files verbatim.
  2. When it returns: READ THE DOC (not the agent's exploration). Sanity-check it against the brief; verify the commit exists and the Decision-candidates section is present (possibly empty).
  3. Carry the decision candidates forward to the decisions phase. Record the outcome in the run record.
  4. Dead agent → respawn fresh from the brief + whatever the doc already contains.
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.

  1. 4d ago First seen · 34 lines · 25 tokens per session scan A e58ad0226530

Subscribe to this mod's changes

design is a skill published in the GitHub repository scolladon/craft (2 stars, last pushed 16d ago), licensed MIT. It adds 25 tokens to every session and 437 once invoked, about $0.0001 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.

Related

Other skills, from other repositories

great_cto

Use when the CTO describes a feature, task, or project goal. Orchestrates the full SDLC pipeline automatically based on project type.

avelikiy/great_cto · 32 tokens

vertical-real-estate

Residential-proptech domain knowledge so architect / pm aren't naive when speccing real-estate products (listings, lead-crm, transaction-coordination, property-mgmt). Codifies MLS/IDX reality, listing status lifecycle + syndication canonical-source, long-cycle lead nurture, transaction-coordination as the high-pain…

avelikiy/great_cto · 99 tokens

skeptical-triage

Reusable 3-round self-challenge + arbiter pattern for filtering false positives from findings/verdicts. Use when the cost of a false-positive gate block exceeds the cost of 4 extra LLM turns.

avelikiy/great_cto · 49 tokens

anti-patterns

Catalogue of known SDLC anti-patterns that greatcto agents must actively reject when reviewing architecture, plans, code, or post-mortems. Used by architect (pre-impl), pm (planning), senior-dev (impl), l3-support (post-incident).

avelikiy/great_cto · 59 tokens

cost-model

Standardized cost-estimation framework for greatcto plans. Forces explicit LLM cost, infra cost, human-supervision time, and the (defensible) human-equivalent comparison. Output format is parsable by the board's /api/cost path — must follow exactly.

avelikiy/great_cto · 59 tokens

pm-planning

Decomposition methodology for pm agent — turns an approved ARCH document into a Beads task list with explicit dependencies, time-boxes, and acceptance criteria. The pipeline can only orchestrate work it can see; this skill defines what "seeable work" looks like.

avelikiy/great_cto · 57 tokens