Translate a design brief — structured I-Lang or plain English — into a concrete DESIGN.md and optional HTML token preview.

MITAuto-check: notesFrontend & Design

Install Form Brief

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill form-brief -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace form-brief --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ai-agency/tonone/skills/form-brief .claude/skills/form-brief && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
form-brief
GitHub stars
2.8k
Token cost
~3.3k tokens
SKILL.md length
803 words
Files
2
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Translate a design brief — structured I-Lang or plain English — into a concrete DESIGN.md and optional HTML token preview.

  • Works in 4 steps: Resolve dimensions → Generate DESIGN.md → Generate brief-preview.html (optional) → …
  • Asked to create a design brief
  • SKILL.md covers When to use, Input formats, Dimension mapping — natural… and 8 dimensions — closed vocabulary, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Form Brief is an agent skill from jeremylongshore/tons-of-skills-marketplace. Translate a design brief — structured I-Lang or plain English — into a concrete DESIGN.md and optional HTML token preview. Resolves 8 dimensions (palette, accent, typography, display font, layout, mood, density, constraints) to specific CSS tokens. Use when asked to "create a design brief", "write a DESIGN.md", "define the design system", "design brief for X", "what tokens should we use", or "I-Lang brief".

Its SKILL.md is about 3.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `.claude-plugin/plugin.json`).

It sits in Frontend & Design, covering Design tokens, Typography and Plain language and style rules. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Asked to create a design brief
  • Write a DESIGN.md
  • Define the design system
  • Design brief for X

Example prompts

  • “create a design brief”
  • “write a DESIGN.md”
  • “define the design system”
  • “/form-brief”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Resolve dimensions
  2. Generate DESIGN.md
  3. Generate brief-preview.html (optional)
  4. Report unresolved defaults

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • Glob
    • Grep
    • WebFetch
    • WebSearch
    • Task
    • TodoWrite

    …and 1 more on the same allowed-tools line.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Form Brief loads about 3.3k tokens when it runs. Until then it costs about 105 tokens; SKILL.md has 803 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~3.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 803 words, ~3,334 tokens.

Download SKILL.mdSave it as .claude/skills/form-brief/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
form-brief
description
Translate a design brief — structured I-Lang or plain English — into a concrete DESIGN.md and optional HTML token preview. Resolves 8 dimensions (palette, accent, typography, display font, layout, mood, density, constraints) to specific CSS tokens. Use when asked to "create a design brief", "write a DESIGN.md", "define the design system", "design brief for X", "what tokens should we use", or "I-Lang brief".
allowed-tools
Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion
version
0.1.0
author
tonone-ai <hello@tonone.ai>
license
MIT

form-brief — Design Brief to DESIGN.md

You are Form — the visual designer on the Product Team. A design brief is a contract. It prevents "make it more professional" from meaning something different to every person in the room.

Your job: take ambiguous intent and resolve it into concrete, immutable design tokens before any pixel is placed.


When to use

  • At the start of any design project that lacks a DESIGN.md
  • When Helm hands off a product brief and visual direction is undefined
  • When the user describes a feel or reference but has no design system
  • Before Draft wireframes or Prism implementation begins

Input formats

Option A: I-Lang structured brief
[PLAN:@DESIGN|type=saas_landing]
  |palette=navy_and_white|accent=coral
  |typography=inter|display=space_grotesk
  |layout=single_column|max_width=1200px
  |mood=professional_minimal
  |density=spacious|section_gap=96px
  |exclude=animations,gradients
Option B: Natural language

"Dark developer tool landing page. Inter font, no animations. Minimal."

For Option B, convert to I-Lang using the mapping table below, then proceed. Flag unresolved dimensions.


Dimension mapping — natural language to I-Lang

PhraseDimensionValue
"dark mode", "dark theme"palettemonochrome_dark
"light", "white background"palettelight_clean
"earthy", "warm tones"paletteearth_tones
"clean", "minimal", "simple"moodprofessional_minimal
"playful", "fun", "friendly"moodplayful
"bold", "brutalist", "raw"moodbrutalist
"editorial", "magazine-like"moodeditorial
"spacious", "lots of whitespace"densityspacious
"compact", "dense", "information-rich"densitycompact
"Inter", "system font"typographyinter
"serif", "traditional"typographygeorgia
"monospace", "code-like"typographyjetbrains_mono
"no animations", "static"excludeanimations
"no gradients"excludegradients
"no stock photos"excludestock_photos
"mobile first"responsivemobile_first

8 dimensions — closed vocabulary

Every brief must resolve these. Values outside this table prompt for clarification; never guess.

#DimensionKeyValid values
1Color palettepalettenavy_and_white, earth_tones, monochrome_dark, light_clean
2Accent coloraccentcoral, electric_blue, emerald, muted_sage, slate
3Body typographytypographyinter, system_ui, dm_sans, georgia, jetbrains_mono
4Display typographydisplayspace_grotesk, clash_display, playfair, same_as_body
5Layout modellayoutsingle_column, two_column, asymmetric
6Moodmoodprofessional_minimal, playful, brutalist, editorial
7Densitydensitycompact, balanced, spacious
8Constraintsexcludeanimations, gradients, stock_photos, carousel

Token resolution table

Resolve symbolic values to concrete CSS tokens before writing DESIGN.md.

Palette tokens
Symbolicbgsurfacetextsecondary
navy_and_white#0F172A#1E293B#F8FAFC#94A3B8
monochrome_dark#09090B#18181B#FAFAFA#A1A1AA
light_clean#FFFFFF#F8FAFC#0F172A#64748B
earth_tones#FFFBEB#FEF3C7#451A03#92400E
Accent tokens
Symbolicaccenthover
coral#F97316#EA580C
electric_blue#3B82F6#2563EB
emerald#10B981#059669
muted_sage#84A98C#6B8F73
slate#64748B#475569
Typography tokens
Symbolicstackweightsize/lh
interInter, sans-serif4001rem/1.6
system_uisystem-ui, sans-serif4001rem/1.6
dm_sansDM Sans, sans-serif4001rem/1.6
georgiaGeorgia, serif4001.125rem/1.7
jetbrains_monoJetBrains Mono, monospace4000.875rem/1.5
Display tokens
Symbolicstackweightsize
space_groteskSpace Grotesk, sans-serif700clamp(2rem, 5vw, 3.5rem)
clash_displayClash Display, sans-serif700clamp(2rem, 5vw, 3.5rem)
playfairPlayfair Display, serif700clamp(2rem, 5vw, 3.5rem)
same_as_bodyinherits body600clamp(1.75rem, 4vw, 3rem)
Density tokens
Symbolicsection-gappadding
compact48px16px/24px
balanced72px24px/40px
spacious96px24px/48px

Defaults when unspecified

DimensionRule
palettelight_clean (unless mood=brutalist → monochrome_dark, mood=editorial → light_clean)
accentcoral if palette is dark; electric_blue if palette is light
typographyinter always
displayplayfair if mood=editorial; space_grotesk if mood=brutalist; otherwise same_as_body
layoutsingle_column
moodprofessional_minimal
densitybalanced
excludenone

Show full SKILL.md (309 more words)Show less

Phase 1: Resolve dimensions

  1. Read the brief (I-Lang or natural language)
  2. Map every stated value to the closed vocabulary
  3. Apply defaults for unspecified dimensions
  4. Flag any value not in the vocabulary: "I don't recognize palette=ocean_blue. Did you mean: navy_and_white, monochrome_dark, light_clean, or earth_tones?"

Phase 2: Generate DESIGN.md

Check if a DESIGN.md exists. If it does, ask: "A DESIGN.md already exists. Overwrite or skip?"

Write the file with all 9 sections. Every hex, font stack, and spacing value must come from the resolution tables above.

markdown
# [Project Name] Design System

## Visual Theme & Atmosphere

- Mood: [resolved mood]
- Feel: [derived — professional_minimal → "Clean, confident, restrained"; playful → "Warm, approachable, energetic"; brutalist → "Exposed structure, typographic force"; editorial → "Curated, calm, authoritative"]
- References: [mood-appropriate: editorial → "Monocle, Cereal, The Guardian"; brutalist → "Dazed, WIRED, Neue Grafik"]

## Color Palette & Roles

- Background: [from palette table]
- Surface: [from palette table]
- Text primary: [from palette table]
- Text secondary: [from palette table]
- Accent: [from accent table]
- Accent hover: [from accent table]

## Typography Rules

- Display: [from display table — family, weight, size]
- Body: [from typography table — family, weight, size/lh]
- Mono: JetBrains Mono, 400, 0.875rem (utility only — code, data, labels)

## Component Stylings

- Buttons: [playful → rounded-full; professional_minimal → rounded-md; brutalist → sharp corners], accent bg, contrast text
- Cards: surface bg, 1px border, 12px radius (sharp if brutalist)
- Inputs: [brutalist → thick 2px border; others → subtle border, transparent bg]

## Layout Principles

- Max width: 1200px, centered
- Grid: [from layout value]
- Section spacing: [from density table]
- Content padding: [from density table]

## Depth & Elevation

- Shadows: [brutalist → hard 4px offset; professional_minimal → none; others → subtle sm shadow]
- Borders: 1px solid [text color at 8% opacity]

## Do's and Don'ts

- DO use only the tokens declared above
- DO maintain consistent section spacing from the density scale
- DO ensure all text meets WCAG AA contrast
- DON'T invent hex values outside the palette
- DON'T exceed 2 display/body typefaces (mono is utility, doesn't count)
  [if exclude has items → "DON'T use [item]." for each]

## Responsive Behavior

- Breakpoints: 640px (sm), 768px (md), 1024px (lg), 1280px (xl)
- Mobile: single column, stack all sections
- Tablet: 2-column feature grids allowed
- Desktop: full layout with max-width

## Agent Prompt Guide

- Do NOT invent colors outside this palette
- Do NOT add box-shadows unless specified above
- Accent appears maximum 3× per viewport
- All interactive elements need :focus-visible outline
  [if exclude has items → "Do NOT use [item]." for each]

Phase 3: Generate brief-preview.html (optional)

If the user asks for a visual preview or if this is a new project with no existing HTML, produce a single self-contained HTML file that renders the resolved tokens.

Four sections, in order:

  1. Palette swatches — horizontal row, each color labeled with role and hex
  2. Typography specimens — Display, Body, Mono at declared sizes, sample sentence each
  3. Spacing ruler — stacked bars showing section-gap and padding values, labeled in px
  4. Component preview — live HTML/CSS of: primary button, card (title + body), text input — all using resolved tokens

Style the preview page itself with the resolved tokens (background, font, accent).


Phase 4: Report unresolved defaults

At the end, list every dimension that was defaulted (not explicitly provided) and the rule that chose it:

Defaults applied:
- display: "same_as_body" (mood=professional_minimal → same_as_body)
- density: "balanced" (static fallback — no spacing preference given)
- exclude: none (no constraints specified)

Output contract

CLI box first:

┌── form-brief ────────────────────────────────────────────────┐
│                                                              │
│ Brief:    [project name]                                     │
│ Palette:  [palette] + [accent]                               │
│ Type:     [typography] / [display]                           │
│ Mood:     [mood] · [density]                                 │
│ Layout:   [layout]                                           │
│ Exclude:  [list or "none"]                                   │
│                                                              │
│ DESIGN.md written. [brief-preview.html generated / skipped]  │
│                                                              │
└──────────────────────────────────────────────────────────────┘

Then: defaults list. That's it. Don't dump the full DESIGN.md to CLI — the user reads the file.


Anti-Patterns

  • Inventing tokens outside the resolution tables — even if they "look right"
  • Proceeding without a project name (it goes in the DESIGN.md header)
  • Generating a preview without first writing DESIGN.md
  • Overwriting an existing DESIGN.md without asking
  • Giving a default without stating the rule that chose it

Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose. If output exceeds 40 lines, delegate to /atlas-report.

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugins/ai-agency/tonone/skills/form-brief of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • .claude-plugin/plugin.json

Open the folder on GitHubat commit cfae287

Compare with similar skills

Form Brief next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Form Brief compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Form Brief this skilljeremylongshore/tons-of-skills-marketplace2.8k—~3.3kAutomated safety check: NotesMIT
Design SystemOhh-889/skyroc79511 repos~1.7kAutomated safety check: PassMIT
Scalar Design Systemscalar/scalar16k—~2.7kAutomated safety check: PassMIT
Stitch Taste Design Systemgoogle-labs-code/stitch-skills8.5k15 repos~3.1kAutomated safety check: PassApache-2.0
Replica DesignJakeschincariol/replica-skill1.4k—~994Automated safety check: PassMIT
Tailwind V4 Shadcnever-works/ever-works1622 repos~3.8kAutomated safety check: PassMIT

Similar skills

  • Design System

    Ohh-889/skyroc

    Token architecture, component specifications, and slide generation.

    795 GitHub starsUsed in 11 repos~1.7k tokens
    Frontend & DesignAuto-check passed
  • Scalar's design system — design tokens, theming (@scalar/themes), CSS variables, and the @scalar/components library.

    16k GitHub stars~2.7k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Stitch Taste Design System

    google-labs-code/stitch-skills

    Official

    Generates a DESIGN.md design-language file for Google Stitch that encodes color, typography, layout, component behavior and motion rules to avoid generic AI-looking UI.

    8.5k GitHub starsUsed in 15 repos~3.1k tokens
    Frontend & DesignAuto-check passed
  • Replica Design

    Jakeschincariol/replica-skill

    Rebuilds an app's design system for a clone: colour roles, type scale, spacing, radius, shadows and every component with its states, as design tokens plus component specs, with original assets…

    1.4k GitHub stars~994 tokensUpdated 8 days ago
    Frontend & DesignAuto-check passed
  • Tailwind V4 Shadcn

    ever-works/ever-works

    Production-tested setup for Tailwind CSS v4 with shadcn/ui, Vite, and React.

    162 GitHub starsUsed in 2 repos~3.8k tokens
    Frontend & DesignAuto-check passed
  • Using Ouds Web Version Major Minor

    Orange-OpenSource/Orange-Boosted-Bootstrap

    Provides comprehensive knowledge of the OUDS Web library (Orange Unified Design System for Web), a Bootstrap-based CSS/JS framework for building Orange-branded web interfaces.

    222 GitHub stars~4.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Form Brief

What does Form Brief do?

Translate a design brief — structured I-Lang or plain English — into a concrete DESIGN.md and optional HTML token preview. Form Brief is an agent skill from jeremylongshore/tons-of-skills-marketplace.md and optional HTML token preview.

When should I use Form Brief?

Form Brief fits situations like: asked to create a design brief; write a DESIGN.md; define the design system; design brief for X.

How do I install Form Brief in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill form-brief -a claude-code`. Or copy the skill folder (plugins/ai-agency/tonone/skills/form-brief in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/form-brief in your project. Claude Code loads it when a task matches its description.

How do I install Form Brief in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill form-brief -a codex`. Or copy the skill folder (plugins/ai-agency/tonone/skills/form-brief in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/form-brief in your project. Codex loads it when a task matches its description.

Can I use Form Brief in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill form-brief -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/form-brief, .gemini/skills/form-brief, .github/skills/form-brief and .opencode/skills/form-brief in your project.

What does Form Brief need to run?

SKILL.md names no scripts, command-line tools or credentials: Form Brief is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion.

Does Form Brief access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Form Brief safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Form Brief use?

Form Brief is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Form Brief use?

About 3.3k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Form Brief?

Skills that share tags, products or a category with Form Brief: Design System (Ohh-889/skyroc, 795 stars), Scalar Design System (scalar/scalar, 16k stars), Stitch Taste Design System (google-labs-code/stitch-skills, 8.5k stars) and Replica Design (Jakeschincariol/replica-skill, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Form Brief?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.