AI Agents & Skills
Teach your AI pair-programmer the Boltdocs architecture, routing, components, and styling conventions so it gives you better, more relevant suggestions.
Every AI assistant is only as smart as the context you give it. Whether you use Cursor, Claude Code, GitHub Copilot, or Gemini Code Assist, our structured skill teaches your tool how Boltdocs works under the hood—so it stops guessing and starts generating code that fits your project.
The skill is a set of markdown files that act as a localized knowledge base. AI tools read them to learn about boltdocs.config.ts, file-system routing, built-in MDX components, and the Tailwind CSS v4 styling system.
Installation
We ship an automated installer script install-ai-agents.sh at the project root. It copies the skill files to the folder your AI environment expects.
Quick Install (Standalone)
If you're adding the skill to an existing Boltdocs project without cloning the framework repository:
curl -fsSL https://raw.githubusercontent.com/bolt-docs/boltdocs/main/install-ai-agents.sh | bash
The script detects whether local skill files exist. If they don't, it downloads them from GitHub automatically.
Install from a Cloned Repository
If you have the Boltdocs repository cloned, run the script directly — it uses the local files so the skill always matches your checkout:
./install-ai-agents.sh
Run the installer from your project's root directory, not the Boltdocs framework directory. The --output-dir flag lets you point it anywhere.
Script Reference
The installer supports these flags for automated or CI workflows:
| Flag | Value | Description |
|---|---|---|
-t, --target | cursor, claude, copilot, agents, all | Which editor or AI environment to configure. |
-o, --output-dir | <path> | Custom installation directory (overrides default paths). |
-y, --yes | — | Non-interactive mode — skips prompts and confirms automatically. |
-h, --help | — | Print usage information and exit. |
Default Target Directories
| Target | Installation Path |
|---|---|
cursor | .cursor/skills/boltdocs/ |
claude | .claude/skills/boltdocs/ |
copilot | .copilot/skills/boltdocs/ |
agents (Gemini) | .agents/skills/boltdocs/ |
Example: Install for Claude in CI
./install-ai-agents.sh --target claude --yes
What's Next?
Plugin System
Extend your project by writing custom Remark, Rehype, and Vite plugins.
Troubleshooting
Resolve common configuration mismatches or SSG bundle warnings.
