# Signal DS — Agent Kit

Everything an AI coding agent needs to build against the Signal Design System
correctly. Nothing here is wired up automatically — copy what you need.

| File | Purpose |
|---|---|
| `SKILL.md` | Claude Code / Cursor skill — copy into `.claude/skills/signal-design-system/` or `.cursor/skills/signal-design-system/` |
| `UX-CONSTITUTION.md` | Product UX rulebook — offline fallback; the live, always-current copy is served over MCP (`docs-show` id `documentation-ux-constitution--docs`) |
| `mcp.json` | MCP server config — merge its `mcpServers` block into your tool's own config (`.mcp.json` for Claude Code, `.cursor/mcp.json` for Cursor, `.vscode/mcp.json` for Copilot under the `servers` key, or your tool's equivalent) |
| `postinstall.mjs` | Prints the setup banner you saw after `npm install` — safe to ignore/delete, changes nothing on its own |

Full walkthrough, including agents whose MCP config lives in a global/user file
rather than a project file (Windsurf, Cline, Codex CLI): see
`docs/AGENT-KIT.md` (shipped alongside this folder) or
[Build with AI](https://main--69ba4becb6eabba83cbd8bc1.chromatic.com/?path=/docs/documentation-build-with-ai--docs)
in the hosted Storybook.

MCP URL (hosted, works without any local setup):
`https://main--69ba4becb6eabba83cbd8bc1.chromatic.com/mcp`