# How do I make an agent follow a design skill every time?

Updated 2026-11-21 · https://briefatto.com/guides/make-an-agent-follow-a-skill/

Give the skill a check that fails: Briefatto Board's `board check` renders each piece and sets exit status 1 when the floor is broken, so the agent, a git hook or CI stops on it. The skill stays short, and the brand lives in a frozen DESIGN.md that AGENTS.md and CLAUDE.md point to.

## Instructions ask, programs decide

A skill is text the agent reads. What holds the line is a program the agent cannot talk its way past. Briefatto Board splits the job:

- **SKILL.md holds the procedure:** which board commands to run, and in what order.
- **DESIGN.md holds the brand:** the project's frozen design guide.
- **`board check` holds the floor:** it renders each piece and fails it for clipped, off-canvas, overlapping or too-small text, fonts that never loaded, contrast below WCAG and Impeccable's anti-patterns. It checks the brand name where it appears, and a campaign piece's required copy.

## Put the check where it cannot be skipped

The block in AGENTS.md and CLAUDE.md tells the agent to run `board check` on every piece before handing it over. For a hard stop outside the agent, run the same command in a git pre-commit hook: Git aborts the commit when the hook exits non-zero. See [run a design check in a pre-commit hook](https://briefatto.com/guides/design-check-in-pre-commit-hook/).

## Questions and answers

### Can a skill force the model to obey?

The program does. Briefatto Board pairs the skill with `board check`, which writes a receipt of which checks ran and fails the piece with exit status 1.

### Where does Briefatto Board put its skill?

Under `.claude/skills/briefatto-board/`, with a marked block in AGENTS.md and CLAUDE.md that points to it.

### Is Briefatto Board free?

Yes. It is open source under the Apache-2.0 licence and installs with `npx briefatto-board install`.

## Try it

```
npx briefatto-board install
```

Briefatto Board is free and open source under Apache-2.0: https://github.com/Briefatto/briefatto-board

## Related guides

- [How to make an AI agent follow your design rules](https://briefatto.com/guides/make-an-agent-follow-your-design-rules/)
- [Design checks as scripts instead of prompts: how board check works](https://briefatto.com/guides/deterministic-design-checks-vs-prompts/)
- [Claude Code forgets your CLAUDE.md design rules mid-session: what to do](https://briefatto.com/guides/claude-code-forgets-claude-md/)
- [How do you enforce design checks in a pre-commit hook?](https://briefatto.com/guides/design-check-in-pre-commit-hook/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://git-scm.com/docs/githooks (checked 2026-11-21)
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
