> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inklyai.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills for agents

> Install Inkly skills for agents and load task-specific playbooks for capture, HTML capture, polishing, and schema reference.

Inkly ships an agent skill for the CLI. Install it once so local coding agents can discover how to scaffold hubs, capture demos, preview locally, validate files, sync assets, and publish snapshots.

The installed skill is an index. It gives agents the command map and points them to focused task skills when they need deeper instructions.

## Install the Inkly CLI skill

Install the CLI first:

```bash theme={null}
npm install -g @inkly-org/cli
inkly version
```

Then install or refresh the bundled skill:

```bash theme={null}
inkly skills install
```

This command installs the Inkly CLI skill into every supported AI coding agent detected on your machine. Re-run it after upgrading the CLI.

<Note>
  `inkly skills install` uses `npx` under the hood. If it fails because `npx` is missing, install Node.js 20 or later and run the command again.
</Note>

## Install by agent provider

Use the same install command for each supported agent provider. The installer detects local agent directories and installs the Inkly skill where each provider expects local skills.

| Agent provider     | How to install                                                                                                                           | How to use it                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Claude Code        | Run `npm install -g @inkly-org/cli`, then `inkly skills install`. Restart Claude Code if it was already open.                            | Ask Claude Code to use the Inkly skill when it captures, previews, validates, or polishes demos. |
| Cursor             | Run `npm install -g @inkly-org/cli`, then `inkly skills install` from a terminal. Restart Cursor so the agent can pick up the new skill. | Ask Cursor Agent to use the Inkly skill in the workspace that contains your hub or product.      |
| Codex              | Run `npm install -g @inkly-org/cli`, then `inkly skills install`. Start a new Codex session after installation.                          | Ask Codex to use the Inkly skill before it runs capture, polish, or publishing commands.         |
| Other local agents | Run `inkly skills install`. If the provider supports the open skills layout, the installer can add Inkly automatically.                  | If the provider is not detected, paste the relevant task skill URL into the agent prompt.        |

After installation, ask your agent to use the Inkly skill when it works on demos. For example:

```text theme={null}
Use the Inkly CLI skill to capture and polish a demo of this product flow.
```

## Task skills

For specific jobs, the Inkly CLI skill tells agents to load one of these focused playbooks.

| Skill                 | Use it when                                                                                          | URL                                                                             |
| --------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `agent-capture`       | You want an image/video demo of a product URL.                                                       | [Open skill](https://www.app.inklyai.dev/__inkly/skills/agent-capture.md)       |
| `agent-html-capture`  | You want an HTML demo with self-contained page snapshots.                                            | [Open skill](https://www.app.inklyai.dev/__inkly/skills/agent-html-capture.md)  |
| `agent-demo-polish`   | You want to polish a raw capture or assemble a demo from existing screenshots, videos, or materials. | [Open skill](https://www.app.inklyai.dev/__inkly/skills/agent-demo-polish.md)   |
| `inkly-cli-reference` | You need precise `inkly.json`, `demo.config.json`, or CLI/schema details.                            | [Open skill](https://www.app.inklyai.dev/__inkly/skills/inkly-cli-reference.md) |

## If skills are not installed

You can still use Inkly with any agent that can read a URL and run commands. Paste the relevant task skill URL into the agent prompt.

```text theme={null}
Read this Inkly skill and follow it exactly:
https://www.app.inklyai.dev/__inkly/skills/agent-capture.md

Capture an interactive demo of:
https://app.example.com
```

This fallback works well when you are using a hosted agent, a locked-down workstation, or an agent that does not yet support installed skills.

## When to use each skill

* Use `agent-capture` by default. It creates screenshot/video demos and supports motion.
* Use `agent-html-capture` when you need crisp text, editable captured content, or HTML snapshots.
* Use `agent-demo-polish` after capture, when the demo needs clearer labels, stronger copy, better annotations, chapters, covers, or cleanup.
* Use `inkly-cli-reference` when the agent needs exact file shapes or schema details.

For the capture command surface, see [Agentic capture](/cli/capture). For the full command list, see [CLI commands](/cli/commands).