Skip to main content
skill CX Codex

design-brief · podo — Claude Code skill: what it does, how to install

The design-brief skill turns an I-Lang or plain-language visual brief into DESIGN.md and an HTML preview. Use it when the interface direction is still vague.

MIT 211 installs ★ 35 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add podo/design-agent-skills --skill design-brief -a claude-code
Open on GitHub

What design-brief does

The skill accepts either an I-Lang block or a natural-language description. It maps the request to eight visual areas, including palette, accent, body and display type, layout model, mood, density, and exclusions. Missing choices are filled with defaults that fit the stated mood.

It writes concrete design tokens to DESIGN.md and creates brief-preview.html for a visual check. This covers visual direction rather than product planning, so it does not define audience, goals, or success metrics. The skill asks before replacing an existing DESIGN.md, which prevents a silent overwrite.

What it helps with

  • turn a vague interface description into explicit visual decisions
  • write a design specification to DESIGN.md
  • generate an HTML preview of the proposed direction
  • convert an I-Lang brief into concrete design tokens
  • keep visual direction separate from a product brief

Example prompts for the agent

  • Turn this visual request into a design brief, then write the result to DESIGN.md.
  • Convert this I-Lang brief into a concrete specification and create brief-preview.html.
  • Define the visual direction from this description, including palette, typography, layout, and exclusions.

How to install design-brief

1Skills CLI (Vercel)

npx skills add podo/design-agent-skills --skill design-brief -a claude-code

2Manually: put the files in place

~/.claude/skills/design-brief/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/design-brief/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about design-brief

How do I install design-brief in Claude Code?

Run npx skills add podo/design-agent-skills --skill design-brief -a claude-code, then check ~/.claude/skills/design-brief/SKILL.md.

What does the design-brief skill do?

It turns an I-Lang or plain-language visual brief into DESIGN.md with concrete design values and an HTML preview named brief-preview.html.

Do I need to write the brief in I-Lang?

No. The skill accepts both structured I-Lang input and a description written in plain language.

Source text

SKILL.md · MIT
---
name: design-brief
description: |
  Turns a structured visual design brief (I-Lang format or plain language) into a
  concrete DESIGN.md spec plus an HTML preview. Forces the vague parts of a request
  ("make it professional") into explicit dimensions: palette, accent, typography,
  layout, mood, density, constraints. Built for OpenDesign; works standalone.
triggers:
  - "design brief"
  - "design spec"
  - "visual brief"
  - "I-Lang brief"
  - "structured brief"
  - "brief to DESIGN.md"
das:
  category: design-review
  upstream: "https://github.com/nexu-io/open-design"
  upstream_path: "skills/design-brief/SKILL.md"
  version: latest
  install: true
---

# design-brief

> Catalogue stub — full skill: [nexu-io/open-design](https://github.com/nexu-io/open-design/blob/main/skills/design-brief/SKILL.md)

<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree

1. **Is the full skill already installed?**
   - Global: `f=~/.agents/skills/design-brief/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - Project: `f=.agents/skills/design-brief/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → the skill is installed as `design-brief`, invoke it and proceed
   - `pointer` → go to step 2

2. **Detect scope, then install:**

   ```bash
   [ -e ~/.agents/skills/design-brief ] && echo "global" || echo "project"
   ```

   **Global:**
   ```bash
   npx skills add https://raw.githubusercontent.com/nexu-io/open-design/main/skills/design-brief/SKILL.md -g -y
   ```

   **Project:**
   ```bash
   npx skills add https://raw.githubusercontent.com/nexu-io/open-design/main/skills/design-brief/SKILL.md -y
   ```
   > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation.

**Heads-up**

- **License:** Apache-2.0
- **Name collision:** `design-brief` is also written by `designer-skills` (its install or its catalogue pointer); installing both overwrites the earlier one.
<!-- das:install:end -->

## Invoke after install

- Skill name: `design-brief`
- Trigger phrases: "design brief", "visual brief", "I-Lang brief", "structured brief"

## What it does

Takes a design brief either as an I-Lang structured block (`[PLAN:@DESIGN|type=saas_landing] |palette=navy_and_white |accent=coral ...`) or as natural language ("clean, minimal, dark-mode landing page for a developer tool, Inter, no animations"), maps it onto eight visual dimensions (palette, accent, body and display typography, layout model, mood, density, exclusions), fills unspecified dimensions with mood-compatible defaults, and writes a `DESIGN.md` with concrete tokens plus a `brief-preview.html` preview. Asks before overwriting an existing `DESIGN.md`.

This is a visual-direction brief, not a product brief: there is no audience, goals or success-metrics content. The frontmatter carries an OpenDesign-specific block that other agents ignore; the skill itself is a single self-contained file.

## When NOT to use

- A product or project brief with goals, audience, success criteria and scope: the `designer-skills` package has a `design-brief` skill that writes exactly that. It installs into the same `design-brief` directory as this one, so choose one of the two
- Building a full design system with a consultation process (use `design-consultation`)
- When the visual direction is already fixed in an existing `DESIGN.md`

© podo · MIT · podo/design-agent-skills

Similar skills

All skills for Design →

design-brief by other authors comes first.

design-brief julianoczkowski Interviews you about a feature, scans the codebase, and saves a design brief as markdown. Useful before you start building a page. CX Codex +1 5,500installs design-brief Owl-Listener design-brief drafts a project brief covering problem space, audience, constraints, and success criteria. Built for kicking off a specific task or feature. CX Codex +1 2,500installs hackathon-brief-design Samuel Berthe hackathon-brief-design drafts the document hackathon teams need before building: challenge prompts, entry rules, track descriptions, and submission requirements. Useful when organizers are turning event decisions into clear instructions. CX Codex +1 6,800installs design-brief-generator jamesrochabrun design-brief-generator is a Claude Code skill that builds structured design briefs. It activates for requests about project requirements, goals, and design planning. CX Codex +1 181installs tool-design-sprint-brief product-on-purpose tool-design-sprint-brief builds a two-page brief before a Design Sprint starts: challenge, questions, roles, customer recruiting, prototype medium and success criteria. CX Codex +1 708installs brief-to-tasks julianoczkowski brief-to-tasks converts a design brief into an ordered checklist of vertical slice tasks and saves it as a markdown file. CX Codex +1 5,400installs motion-brief-writer charlie947 motion-brief-writer turns a rough idea for an animated graphic into a precise build prompt for Claude. Asks for what's missing and never invents a number. CX Codex +1 3,400installs creative-brief iart-ai creative-brief turns vague client input into a locked motion design brief and drafts targeted clarifying questions. Useful when scoping projects before design starts. CX Codex +1 1,100installs

From the same set108

The whole set →
distinctive-frontend distinctive-frontend — a skill for Claude Code and other coding agents that generates interfaces in four themed styles instead of default AI aesthetics. Pick a theme by name and the component code follows that visual direction. CX Codex +1 633installs emilkowalski-skill emilkowalski-skill applies Emil Kowalski's design engineering rules: custom easing curves, animation decision flow, typography standards, and mobile interaction patterns. CX Codex +1 298installs apple-hig-skills The apple-hig-skills skill gives your agent Apple Human Interface Guidelines advice for iOS, macOS, visionOS, watchOS, and tvOS. Use it when designing or reviewing a platform-specific interface. CX Codex +1 286installs interaction-design Hands the agent a working reference for interaction design: flows, component states, micro-interactions and handoff notes. CX Codex +1 284installs anthropics-skills anthropics-skills is a Claude Code skill that installs six official Anthropic skills for UI work, HTML artifacts, graphics, themes, brand guidelines and PowerPoint. CX Codex +1 280installs antvis-chart-skills antvis-chart-skills is a Claude Code skill for creating charts, diagrams, and infographics with AntV, including data visualization and turning text into diagrams. CX Codex +1 277installs figma-official-skills figma-official-skills is a Claude Code skill package that moves Figma designs into code, builds design-system libraries and links Figma components to repository components. CX Codex +1 271installs shadcn-ui Guides AI coding agents through searching, adding, and composing shadcn/ui components accurately. CX Codex +1 271installs

Project sponsors

Companies that keep this analytics open