> ## Documentation Index
> Fetch the complete documentation index at: https://puzzlet-9ba7bb98.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AgentMark agent skill

> Install the AgentMark skill so Claude Code, Codex, Cursor, or GitHub Copilot already know how to author prompts, run experiments, and deploy in any project, including ones you didn't scaffold with create agentmark

The AgentMark **agent skill** teaches AI coding agents how to use AgentMark: CLI commands, `.prompt.mdx` authoring, datasets, experiments, evals, and git-based deploys. Once installed, a compatible agent auto-discovers it at session start and applies it whenever AgentMark context appears: `.prompt.mdx` files, `agentmark.json`, `@agentmark-ai/*` imports, or an explicit mention of AgentMark.

<Note>
  This page covers the **agent skill** (workflows and conventions your agent follows). It complements the [docs MCP](/coding-agents/docs-mcp), which lets your editor query AgentMark documentation, and the [gateway MCP](/coding-agents/gateway-mcp), which lets it drive the full AgentMark API: traces, datasets, scores, experiments, apps, and deployments. See [Coding agents](/coding-agents/overview) for how the three fit together.
</Note>

## Installed automatically with `create agentmark`

If you bootstrap a project with the scaffolder, you already have the skill, with no extra steps:

```bash theme={null}
agentmark init
# or the equivalent wrapper: npm create agentmark@latest
```

The scaffolder installs the skill to `./.agents/skills/agentmark/` and symlinks it into each tool's native location (Claude Code, Codex, Cursor, GitHub Copilot, and other [agentskills.io](https://agentskills.io)-compatible tools).

## Adding the skill to an existing project

Pick whichever fits your tooling:

<Tabs>
  <Tab title="Universal (npx skills)">
    Works across Claude Code, Codex, Cursor, GitHub Copilot, Amp, and other agentskills.io-compatible tools:

    ```bash theme={null}
    npx skills add agentmark-ai/skills
    ```

    Files land in `./.agents/skills/agentmark/` with symlinks into per-tool paths created automatically.
  </Tab>

  <Tab title="Claude Code plugin">
    Uses Claude Code's built-in plugin marketplace:

    ```bash theme={null}
    claude
    > /plugin marketplace add agentmark-ai/skills
    > /plugin install agentmark
    ```
  </Tab>

  <Tab title="From the docs URL">
    The skill is also discoverable from any AgentMark docs URL via Mintlify's well-known discovery:

    ```bash theme={null}
    npx skills add https://docs.agentmark.co
    ```
  </Tab>
</Tabs>

After installing, start a new agent session in your project. The agent discovers the skill automatically; there is nothing to enable.

## What the skill contains

```text theme={null}
skills/agentmark/
├── SKILL.md                     # entry point, read by the agent on auto-invoke
├── workflows/                   # one file per common task
│   ├── building-datasets.md
│   ├── creating-prompts.md
│   ├── deploying.md
│   ├── headless-with-mcp.md
│   ├── observability.md
│   ├── running-experiments.md
│   ├── setup-and-integration.md
│   └── using-evals.md
└── reference/                   # auto-generated from source
    ├── cli-commands.md
    └── frontmatter-schema.md
```

## How it stays current

The skill points to live sources. It teaches agents to:

1. Run `agentmark <cmd> --help` for the canonical CLI surface
2. Fetch [`docs.agentmark.co/llms.txt`](https://docs.agentmark.co/llms.txt) for documentation navigation
3. Fetch specific pages from these docs for current content

AgentMark regenerates the bundled `reference/` files from source on every release, so an outdated install still works: the skill always instructs the agent to prefer the live CLI and docs over the bundled copies.

## Related documentation

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/getting-started/quickstart">
    Bootstrap a project with npm create agentmark, skill included
  </Card>

  <Card title="Docs MCP" icon="magnifying-glass" href="/coding-agents/docs-mcp">
    Wire the docs MCP so your editor can query AgentMark documentation
  </Card>

  <Card title="Gateway MCP" icon="wrench" href="/coding-agents/gateway-mcp">
    Drive the full AgentMark API from your editor: traces, datasets, scores, deployments
  </Card>

  <Card title="CLI commands" icon="terminal" href="/reference/cli-commands">
    The command surface the skill drives
  </Card>
</CardGroup>

Next: [Client setup](/getting-started/client-setup) shows what the skill scaffolds when you ask it to set up AgentMark (the client, the dev entry, and the handler).

<div className="mt-8 rounded-lg bg-blue-50 p-6 dark:bg-blue-900/30">
  <h3 className="font-semibold mb-3">Have questions?</h3>
  <p className="mb-4">Reach out any time:</p>

  <ul>
    <li>
      Email the team at <a href="mailto:hello@agentmark.co" className="text-blue-600 hover:text-blue-800 dark:text-blue-400 dark:hover:text-blue-200">[hello@agentmark.co](mailto:hello@agentmark.co)</a> for support
    </li>

    <li>
      Schedule an <a href="https://cal.com/ryan-randall/enterprise" className="text-blue-600 hover:text-blue-800 dark:text-blue-400 dark:hover:text-blue-200">Enterprise Demo</a> to learn about AgentMark's business solutions
    </li>
  </ul>
</div>