Briefatto LabBriefatto Lab

Comparisons

DESIGN.md vs SKILL.md: what each file does

DESIGN.md holds your project's design guide, and SKILL.md holds the procedure your agent follows. Briefatto Board ships both: its SKILL.md tells the agent how to run the board, and the DESIGN.md it freezes is the guide the agent reads before any visual work.

Updated Markdown version

Briefatto BoardFree and open source, Apache-2.0

Blind-tested against Impeccable, Taste Skill and Hallmark

Automated tests, green CI

Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and any agent that reads AGENTS.md

DESIGN.md and SKILL.md side by side

DESIGN.mdSKILL.md
HoldsYour design guide: layout, components, type and voice, plus a generated block of exact stylesThe procedure: which board commands to run, in what order
Lives atThe project root.claude/skills/briefatto-board/ after board install
Changes whenYour brand changes, through board freeze, which stamps a new versionBriefatto Board ships a release
The agent reads itBefore any visual workWhen it runs the board

How one points to the other

board install places the skill under .claude/skills/ and writes a marked block into AGENTS.md and CLAUDE.md that points to it. After board freeze, the same block tells the agent to read DESIGN.md before any visual work and to run board check on every piece before handing it over.

board freeze records source wording and exact styles from a fresh render in a generated DESIGN.md block, validates the authored guidance against those values, then stamps and archives the guide.

Questions and answers

Do I need both DESIGN.md and SKILL.md?

Yes, and you write neither from a blank page. npx briefatto-board install adds the skill, and board freeze stamps your DESIGN.md.

Is SKILL.md a Briefatto format?

No. A skill is a folder with a SKILL.md file, a convention that Claude Code, Cursor, Lovable and OpenCode describe in their own documentation.

Can I put my design rules inside SKILL.md?

Keep them in DESIGN.md. The skill is the procedure; DESIGN.md is your brand, and board freeze versions and validates it.

One guide. Every agent.

Briefatto Board is free and open source under Apache-2.0. One command adds the skill and the pointer your agent reads.

npx briefatto-board install

Sources

  1. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  2. github.com/Briefatto/briefatto-board/blob/main/README.md
  3. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  4. cursor.com/docs/skills checked 2026-11-21
  5. docs.lovable.dev/features/skills checked 2026-11-21
  6. opencode.ai/docs/skills/ checked 2026-11-21
  7. code.claude.com/docs/en/skills checked 2026-11-21
  8. github.com/Briefatto/briefatto-board/blob/main/LICENSE