Agent Skills #

Agent Skills help AI coding assistants like Claude Code, Cursor, and GitHub Copilot use Duet correctly out of the box — automatically pulling in the right component APIs, CSS utilities, and design tokens whenever you ask them to build UI.

What are Agent Skills? #

Agent Skills are an open format for giving AI coding tools task-specific expertise: a folder containing a SKILL.md file with instructions, loaded on demand when it's relevant to what you're asking for. Duet publishes its own skill as the @duetds/skills package, which teaches an AI assistant how to use @duetds/components, @duetds/css, and @duetds/tokens — the component catalog, when to reach for a utility class versus writing new CSS using tokens.

Most modern AI coding tools implement this format, including Claude Code, Cursor, GitHub Copilot, VS Code, Zed, Windsurf, OpenAI Codex, Gemini CLI, Cline, and Tabnine.

Installing the skill #

Run the installer from the root of your project:

npx @duetds/skills

This installs a shared copy at .agents/skills/duet/, which nearly every AI tool reads automatically — Cursor, GitHub Copilot, VS Code, Zed, Windsurf, Codex, Gemini CLI, and Tabnine among them.

Claude Code and Cline read skills from their own dedicated folder instead. If your project already has a .claude/ or .cline/.clinerules folder, the installer detects it and adds that copy automatically. To install explicitly for one of them:

npx @duetds/skills --tool claude

or

npx @duetds/skills --tool cline

Re-run the command after upgrading @duetds/skills to pick up newer components, tokens, or CSS documentation.

Troubleshooting #

If you experience any issues while getting set up with @duetds/skills, please head over to the Support page for more guidelines and help.