AI Agent Skill

Let your coding agent (Claude Code, Cursor, Codex) create accurate AutoKap presets using its knowledge of your project.

What is the AutoKap skill?

The AutoKap skill is a markdown file that gives your coding agent all the context it needs to generate correct preset configurations. Your agent already knows your project's routes, components, and UI — the skill teaches it how to translate that knowledge into AutoKap presets.

Prerequisites

Before installing the skill, make sure you have the following:

A coding agent that supports custom skills or commands — Claude Code, Cursor, Windsurf, or OpenAI Codex.
An AutoKap account with at least one project created in the dashboard.
For direct API mode (optional): an API key already initialized on the machine. Agents can read the stored key from ~/.autokap/config.json instead of asking for another credential.

Install the MCP server

The AutoKap preset skill ships as an MCP resource (autokap://skill/preset-spec) loaded automatically when you install @autokap/mcp. The full install guide for every IDE lives on the CLI documentation page.

Install for Claude Code (one command):

Shell

claude mcp add autokap -- npx -y @autokap/mcp

See the CLI documentation for Cursor, Codex, Windsurf, and Cline install guides.

Verify the installation

From your IDE chat, ask the assistant to load the skill resource:

Text

Call the autokap_get_skill MCP tool and summarize the preset fields it documents.

If the assistant lists preset fields like url, pages, targets, themes, and langs, the skill is correctly exposed by the MCP server.

How does the assistant use the skill?

Two paths work out of the box. The MCP server exposes the autokap-create-preset prompt that scaffolds a new preset and reads the skill resource for context. For hosts that do not support resources, the assistant calls the autokap_get_skill tool to fetch the same content on demand.

Text

Using the autokap-preset skill, inspect this codebase and create a preset for my project "MyApp" (https://myapp.com).

I want to capture the homepage hero section and the pricing page with both light and dark themes. Inspect auth, locale, and theme handling before writing the preset, then sync it so I can run it directly.

Once @autokap/mcp is installed, run the prompt from your IDE chat (Claude Code: type / and pick autokap-create-preset). The assistant then asks for the URL, pages, devices, and locales, and finally calls autokap_create_preset to sync the new preset to your project.

Good to know

Stored API key

No extra credential is required. Once the MCP server is authenticated, the stored API key is reused for preset creation, endpoint access, and other programmatic flows. To run captures, call autokap_start_capture from your IDE or use the autokap CLI binary in CI: autokap run PRESET_ID.

Version control

The skill file can be committed to your repository. This way, every team member and CI environment gets the same skill automatically. The file contains no secrets because credentials are read from the local AutoKap config at runtime.

Keeping the skill up to date

When AutoKap adds new preset fields or capabilities, re-run the agent-specific install command so AutoKap can regenerate the right packaging format. Codex gets the refreshed bundle, while other agents get a refreshed single-file export. If you downloaded the skill manually, re-download it from this page.

Project context matters

The skill works best when your agent has full access to your project's source code. The more routes, components, and selectors the agent can see, the more accurate the generated presets will be. If you're working on a monorepo, point the agent at the relevant package or app directory for best results.

Manual download

Or download the agent-specific flattened export directly from this page:

Download SKILL.md

If your setup cannot run the MCP server, fall back to dropping a file in your repo. The selector below picks the right path for each agent.