design-it

design-it is a skill for Claude Code from smallnest/goal-workflow. It costs 95 tokens per session (1,189 once invoked), scanned A, original, MIT.

A skill for turning a requirement or feature description into a single, self-contained HTML technical design document. The document follows a fixed layout with diagrams, code examples, decisions, tests, and a code index.

In plain words
What is it for?
Use it to create or convert technical specifications into styled HTML design documents with architecture diagrams, sequence diagrams, SQL or configuration examples, test cases, and code references.
Why use it?
It provides a consistent format for sharing technical plans instead of creating each design document from scratch. It also keeps the document's content tied to the requirement and codebase.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the goal-workflow-skills plugin — 20 skills shipped together

Good fit Use it to create or convert technical specifications into styled HTML design documents with architecture diagrams, sequence diagrams, SQL or configuration examples, test cases, and code references.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/smallnest/goal-workflow/design-it
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 smallnest/goal-workflow --skill design-it
Clone the repo
git clone --depth 1 https://github.com/smallnest/goal-workflow

Made for: Claude Code.

Or install goal-workflow-skills, the plugin that ships this one along with the rest of its 20 skills.

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

README.md
[![agentmods](https://agentmods.dev/badge/skills/smallnest/goal-workflow/design-it/github.svg)](https://agentmods.dev/skills/smallnest/goal-workflow/design-it)
Your own site
<a href="https://agentmods.dev/skills/smallnest/goal-workflow/design-it"><img src="https://agentmods.dev/badge/skills/smallnest/goal-workflow/design-it/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-it

Your own site · 80×15
<a href="https://agentmods.dev/skills/smallnest/goal-workflow/design-it"><img src="https://agentmods.dev/badge/skills/smallnest/goal-workflow/design-it.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 95 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,189 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 pass 7 Sept 2026
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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00095 $0.01189
Opus 5.5 $0.00038 $0.00476
Sonnet 5.5 $0.00019 $0.00238
Haiku 4.5 $0.00010 $0.00119

Measured 1mo ago against content hash 7c9ab3e25914, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

design-it 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 1mo 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-it/SKILL.md · 60 lines

How it starts

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

design-it

Overview

Generate a technical design document as one self-contained HTML file in a fixed house style, so every new 需求 produces a visually identical page. The look is not improvised each time — it comes from a fixed <style> block and a fixed section skeleton. Your job is to fill content into that skeleton, never to redesign it.

Core principle: Copy template.html verbatim, then replace only the content. Keep the <style> block byte-for-byte. Consistency comes from not touching the design system.

When to Use

  • The user gives a new requirement / spec / feature and wants a design doc.
  • Converting a .md technical spec into the shareable HTML form.
  • Any request like "生成同样的 html / 用这套模板 / 出一份设计文档".

When NOT to use: quick throwaway notes, a real Markdown deliverable the user wants to stay Markdown, or slide decks.

Workflow

  1. Copy the template. Start from template.html in this skill's directory. Do not hand-roll the <head>/<style> — copy it whole.
  2. Gather real content first. Section titles, field names, SQL, file:line code positions, protoIds — all must come from the actual requirement doc and codebase. Read the code; do not invent identifiers. If a fact is unknown, mark it <span class="pill todo">待确认</span>, never guess.
  3. Fill the skeleton. Rename/reorder <section>s to fit the feature. Keep the section kinds: 已对齐结论 → 业务规则 → 架构图 → 时序 → 数据模型 → 契约 → 清单 → 幂等降级 → 测试用例 → 代码索引 → 变更记录. Drop what doesn't apply; add feature-specific ones in the same style.
  4. Keep TOC and sections in sync. Every <a href="#x"> needs a matching <section id="x">, and vice versa. This is the #1 breakage — verify at the end (see Quick Reference).
  5. Save as docs/<需求名>.html. Don't commit unless asked.

House-Style Rules (non-negotiable)

Element Rule
<style> block Copy verbatim. Never restyle. Colors come from :root CSS variables only.
Code / SQL / YAML Always the template's <pre style="background:#f8fafc;...">. Inside <pre>, escape <→&lt;, >→&gt;, &→&amp;. Unescaped < silently eats content.
Callout boxes .note (橙, 提醒/易错), .tip (蓝, 正向补充), .warn (红, 风险). Use the right color for the meaning.
Diagrams Hand-authored inline <svg> inside <figure>; text uses .svg-t/.svg-s/.svg-title; node fills use :root vars (var(--new-bg) etc.), matching the .legend.
Intro Each section opens with one <p class="lead"> stating what it answers.
Pills .pill.new/.old/.infra/.mq/.prod/.tech/.done/.todo for status tags — reuse, don't invent classes.
Tables Plain <table> — the CSS handles zebra striping and header shading.
Lang <html lang="zh">; body copy in the doc's language (usually 中文).

Read the full file on GitHub · 60 lines

Files

What ships with it

1 file 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.

  1. 1mo ago First seen · 60 lines · 95 tokens per session scan A 7c9ab3e25914

Subscribe to this mod's changes

design-it is a skill published in the GitHub repository smallnest/goal-workflow (295 stars, last pushed 1mo ago), licensed MIT. It adds 95 tokens to every session and 1,189 once invoked, about $0.0004 per session on Opus 5.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-30.

Related

Other skills, from other repositories

frontend-crafting

You MUST use this when building, implementing, redesigning, reviewing, or refining user-facing interfaces - including pages, layouts, forms, navigation, dashboards, and reusable UI components in HTML, CSS, Vue, Nuxt, React, or other frontend frameworks. Also applies to frontend code changes involving responsive…

sentimony/skills · 111 tokens

maintaining-agent-context

You MUST use this when creating, auditing, optimizing, or maintaining repository agent instructions - AGENTS.md, CLAUDE.md, .claude/rules/, and instruction-related SKILL.md content - covering context architecture, always-loaded context cost, stale, duplicated, or conflicting instructions, and keeping agent memory…

sentimony/skills · 82 tokens

negafix

You MUST use this when writing or substantively editing prose in a project (docs, READMEs, marketing copy) and when asked to audit, score, or clean up negative parallelism, the "it's not just X, it's Y" construction. Not for ordinary factual negation.

sentimony/skills · 62 tokens

cross-review

You MUST use this when an implementation plan or a finished implementation needs an independent review by other agent CLIs - by default the opposite CLI (Codex for work done in Claude Code, Claude Code for work done in Codex) together with Antigravity (Gemini) - whether the user asks for a cross-review or a second…

sentimony/skills · 123 tokens

typescript

You MUST use this when working on TypeScript-specific problems - compiler errors, tsconfig, strict typing, type inference, generics, complex type definitions, module resolution, ESM/CJS interoperability, type-checking performance, migration, or monorepo configuration. Also applies to designing or refactoring type-safe…

sentimony/skills · 96 tokens

debugging

You MUST use this when investigating bugs, regressions, failing tests, build or integration failures, flaky behavior, performance anomalies, or other unexpected technical behavior.

sentimony/skills · 34 tokens