design

design is a skill for Claude Code, Codex from jneaimi/evaluate-before-you-build. It costs 99 tokens per session (3,470 once invoked), scanned A, original, MIT.

A solution-design workflow for deciding how a software system should be structured before building it.

In plain words
What is it for?
Use it to compare implementation options, map components and data flow, and produce a design document.
Why use it?
It makes architectural choices and their tradeoffs explicit, including requirements such as reliability or performance.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions CLAUDE.md; names the AskUserQuestion tool.

Good fit Use it to compare implementation options, map components and data flow, and produce a design document.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/jneaimi/evaluate-before-you-build/design
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.

Any agent
npx skills add jneaimi/evaluate-before-you-build --skill design
Clone the repo
git clone --depth 1 https://github.com/jneaimi/evaluate-before-you-build

Made for: Claude Code, Codex.

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/jneaimi/evaluate-before-you-build/design/github.svg)](https://agentmods.dev/skills/jneaimi/evaluate-before-you-build/design)
Your own site
<a href="https://agentmods.dev/skills/jneaimi/evaluate-before-you-build/design"><img src="https://agentmods.dev/badge/skills/jneaimi/evaluate-before-you-build/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.

agentmods 80×15 button for design

Your own site · 80×15
<a href="https://agentmods.dev/skills/jneaimi/evaluate-before-you-build/design"><img src="https://agentmods.dev/badge/skills/jneaimi/evaluate-before-you-build/design.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 99 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,470 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.
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.1 $0.00099 $0.03470
Opus 5 $0.00049 $0.01735
Sonnet 5 $0.00020 $0.00694
Haiku 4.5 $0.00010 $0.00347

Measured 8d ago against content hash b33cc6e68fbc, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, 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 8d 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 · 409 lines

How it starts

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

Solution Design Checkpoint (/design)

A solution architect's checkpoint. Before code gets written, shape the solution: boundaries, components, data flow, tradeoffs, failure modes. The deliverable is a solution design document, not working code.

Core principle: Options without honest tradeoffs are just preferences. Never produce a "chosen approach" until two or more real alternatives have been written down and compared against named non-functional requirements.

Interaction model: Scan-first like /prebuild (context matters for architecture), then evaluate with AskUserQuestion options like /think. This is the bridge skill: it sits between strategy (/think), planning (/plan), and implementation (/prebuild).

How It Differs from the Others

/design /think /plan /prebuild
Focus Solution shape / architecture Strategic decision Delivery / timeline Code generation
Output ADR / design doc Domain-adapted doc Phased plan Working code
Key work Options + tradeoffs + NFRs Evaluate + research Sequence + own Scan + build
Scans code? Yes (context for options) Sometimes Sometimes Yes

Use /design after /think has confirmed why, and before /prebuild generates code. On small features, skip straight to /prebuild. On anything non-trivial or multi-component, design first.

Framework Reference

┌─────────────────────────────────────────┐
│  Level 5: Evaluate     HUMAN → AI      │  Problem, NFRs, chosen option
│  Level 4: Analyze      HUMAN ↔ AI      │  Options + tradeoffs (core)
├─────────────────────────────────────────┤
│  Level 3: Apply        AI → HUMAN      │  Produce design doc
│  Level 2: Understand   AI → HUMAN      │  Walk through the design
│  Level 1: Remember     AI alone        │  Save as ADR
└─────────────────────────────────────────┘

Commands

/design [topic] — Start design session

Begin a new solution design for the described problem.

Read the full file on GitHub · 409 lines

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. 8d ago First seen · 409 lines · 99 tokens per session scan A b33cc6e68fbc

Subscribe to this mod's changes

design is a skill published in the GitHub repository jneaimi/evaluate-before-you-build (2 stars, last pushed 4mo ago), licensed MIT. It adds 99 tokens to every session and 3,470 once invoked, about $0.0005 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

frontend-design-director

Set subject-grounded visual direction for standard or deep UI work, redesign, polish, critique, anti-template review, or design handoff. Skip technical micro-fixes and isolated code edits.

ytvee-dev/webdev-agent-kit · 43 tokens

think

Structured thinking skill implementing Bloom's AI Collaboration Framework v3. Auto-scales depth from stakes (reversibility + reliance): quick 3-question framing for reversible exploration, standard 6-question protocol for real decisions, deep mode with epistemics + teach-back + independent audit for binding one-way…

jneaimi/blooms-ai-collaboration · 158 tokens

frontend-design-intelligence

Ground standard or deep UI work in product category, page pattern, design dials, domain UX risks, and anti-patterns before visual direction. Produces a brief, not code or tool setup.

ytvee-dev/webdev-agent-kit · 45 tokens

frontend-layout-implementer

Implement an approved Design Implementation Spec or screenshot-derived spec in React/Next.js using existing CSS Modules, Redux, TanStack, and Axios conventions. Excludes unrelated stacks, live design tools, and new styling systems.

ytvee-dev/webdev-agent-kit · 49 tokens

design-screenshot-spec

Turn user-supplied screenshots, copied inspect values, exports, assets, or design notes into a strict frontend Design Implementation Spec. Live design links alone are insufficient.

ytvee-dev/webdev-agent-kit · 38 tokens

ios-accessibility-validator

Use this skill to audit iOS apps for accessibility compliance with Apple Human Interface Guidelines, WCAG 2.2 standards, and iOS accessibility best practices.

gygantskiyMatilyock/ios-developer-agents · 0 tokens