design-spec

design-spec is a skill for Claude Code, Codex from limengzhe27-boop/claude-product-doc-skills. It costs 155 tokens per session (4,291 once invoked), scanned A, original, MIT.

A guide that turns product requirements into a DESIGN.md file containing the visual rules for a web project, such as colors, fonts, spacing, animations, and component styles. It expects the project requirements and page list to be defined first.

In plain words
What is it for?
Use it after preparing the PRD—the product requirements document—to define the visual system for an MVP web interface.
Why use it?
It gives developers one written reference for how the interface should look and keeps visual decisions separate from implementation code. It also prevents designing components before the product structure is clear.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Claude Code.

Good fit Use it after preparing the PRD—the product requirements document—to define the visual system for an MVP web interface.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/limengzhe27-boop/claude-product-doc-skills/design-spec
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 limengzhe27-boop/claude-product-doc-skills --skill design-spec
Clone the repo
git clone --depth 1 https://github.com/limengzhe27-boop/claude-product-doc-skills

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-spec

README.md
[![agentmods](https://agentmods.dev/badge/skills/limengzhe27-boop/claude-product-doc-skills/design-spec/github.svg)](https://agentmods.dev/skills/limengzhe27-boop/claude-product-doc-skills/design-spec)
Your own site
<a href="https://agentmods.dev/skills/limengzhe27-boop/claude-product-doc-skills/design-spec"><img src="https://agentmods.dev/badge/skills/limengzhe27-boop/claude-product-doc-skills/design-spec/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-spec

Your own site · 80×15
<a href="https://agentmods.dev/skills/limengzhe27-boop/claude-product-doc-skills/design-spec"><img src="https://agentmods.dev/badge/skills/limengzhe27-boop/claude-product-doc-skills/design-spec.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 155 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,291 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.00155 $0.04291
Opus 5 $0.00077 $0.02145
Sonnet 5 $0.00031 $0.00858
Haiku 4.5 $0.00015 $0.00429

Measured 12d ago against content hash 8d33c8b6a564, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

design-spec 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 12d 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-spec/SKILL.md · 327 lines

How it starts

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

Design Spec — 设计规范生成器

只做一件事:产出一份高质量的 DESIGN.md

代码落地不归本 SKILL 管——交给下游 Claude Code 读 DESIGN.md + PRD.md 自己实现。


与其他 Skill 的衔接关系

/mrd → 从数据分析市场需求 → MRD.md
  ↓
/brd → 判断商业可行性 → BRD.md
  ↓
/prd-writing → 定义产品结构 → PRD/ 文件夹(含 PRD/03-design-handoff.md 设计交接清单)
  ↓
/design-spec → 读 PRD/03-design-handoff.md + PRD/04-pages-components.md → 产出 DESIGN.md(本 Skill)
  ↓
Claude Code 默认能力 → 基于 PRD/ + DESIGN.md 实现 MVP 代码

设计规范是规格层,代码实现是执行层——两层分离,互不污染。

🔒 PRD 必须先于 DESIGN(教学场景的硬性顺序)

本 skill 必须在 PRD 完成后才运行。如果当前目录没有 PRD/ 文件夹(或没有 PRD/03-design-handoff.md),告诉用户先跑 /prd-writing,不要硬上。

为什么这样划线: 0→1 项目还没有"已存在的设计系统"作为约束,必须先定结构(页面/组件/路由)才能定皮肤(颜色/字体/动效)。如果反过来(先 DESIGN 再 PRD),DESIGN 阶段不知道有哪些组件要被定规范,做出的设计是空中楼阁。这条流程顺序在教学场景里是绝对的。


核心原则

  1. DESIGN.md 是显式产物,保存到项目根目录,可手动改、可被任何工具消费
  2. 不写页面代码,代码由 Claude Code 读 DESIGN.md + PRD/ 自己生成
  3. PRD 是上游,本 skill 是下游——0→1 项目必须先有 PRD/ 文件夹,本 skill 读 PRD/03-design-handoff.md 作为输入
  4. 能继承就继承:有 03-design-handoff.md 就读它,有参考 URL/截图就提取
  5. 有数据就用数据,没数据用对话——不要一上来就给问卷
  6. MVP 优先——规范服务于「先把核心功能跑起来」,不要为「将来可能用到」加复杂度
  7. 默认 Web 端响应式网页,除非用户明确说要做 App

启动检测(按优先级)

按以下顺序判断从哪里起步:

  1. 项目根目录已有 DESIGN.md?→ 问用户:沿用 / 修改 / 重建
  2. 项目根目录有 PRD/03-design-handoff.md?(推荐路径,0→1 教学流程的标准入口) → 读它的 7 个小节(产品调性 / 目标用户视觉感受 / 目标市场与语言 / 参考竞品 / 视觉约束 / 组件密度提示 / 输出契约),作为主要输入 → 同时读 PRD/04-pages-components.md 拿到完整页面/组件清单(决定要为哪些组件定样式)
  3. 项目根目录有旧版 PRD.md(单文件版)?→ 读末尾的「设计交接区」字段(兼容历史版本)
  4. 用户给了参考 URL / 截图 / 关键词?→ 直接进入 Phase 1 提取
  5. 啥都没有 → 询问"你跑过 /prd-writing 吗?没跑过的话 0→1 项目建议先跑,本 skill 的输入来源就是 PRD/03-design-handoff.md。如果你坚持跳过 PRD,我可以用 Phase 1 对话兜底引导(最多 3 个问题),但效果会差很多。"

PRD 完成度门禁(情况 2 触发)

读到 PRD/03-design-handoff.md 后,先做 3 项门禁检查再开始设计

  • 03-design-handoff.md 的 §3.1(产品调性关键词)有内容
  • 03-design-handoff.md 的 §3.6(组件清单视觉密度提示)至少列了 1 个页面/组件
  • 04-pages-components.md 存在且能读到组件清单

任何一项不通过,告诉用户:

⚠️ 我读了 PRD/03-design-handoff.md,发现 [具体缺什么]。建议你回 prd-writing 把 03-design-handoff.md 补完再跑本 skill——否则我做出来的设计会和你的页面/组件清单脱节。

Read the full file on GitHub · 327 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. 12d ago First seen · 327 lines · 155 tokens per session scan A 8d33c8b6a564

Subscribe to this mod's changes

design-spec is a skill published in the GitHub repository limengzhe27-boop/claude-product-doc-skills (2 stars, last pushed 1mo ago), licensed MIT. It adds 155 tokens to every session and 4,291 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.

Related

Other skills, from other repositories