Skip to main content
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.
This page covers the agent skill (workflows and conventions your agent follows). It complements the docs MCP, which lets your editor query AgentMark documentation, and the MCP trace server, which lets it query live traces.

​
Installed automatically with create agentmark

If you bootstrap a project with the scaffolder, you already have the skill — no extra steps: 
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-compatible tools).

​
Adding the skill to an existing project

Pick whichever fits your tooling:
Works across Claude Code, Codex, Cursor, GitHub Copilot, Amp, and other agentskills.io-compatible tools:
npx skills add agentmark-ai/skills
Files land in ./.agents/skills/agentmark/ with symlinks into per-tool paths created automatically.
After installing, start a new agent session in your project — the skill is discovered automatically; there is nothing to enable.

​
What the skill contains

skills/agentmark/
├── SKILL.md             # entry point — read by the agent on auto-invoke
├── workflows/           # one file per common task
│   ├── setup-and-integration.md
│   ├── creating-prompts.md
│   ├── building-datasets.md
│   ├── running-experiments.md
│   ├── using-evals.md
│   ├── deploying.md
│   ├── headless-with-mcp.md
│   └── observability.md
├── reference/           # auto-generated from source — CLI commands,
│   └── …                # frontmatter schema, model registry
└── evals/               # scenarios used to validate the skill itself

​
How it stays current

The skill is a thin pointer that delegates to live sources rather than a static snapshot. It teaches agents to:
  1. Run npx agentmark <cmd> --help for the canonical CLI surface
  2. Fetch docs.agentmark.co/llms.txt for documentation navigation
  3. Fetch specific pages from these docs for current content
The bundled reference/ files are regenerated from source on every release, so a stale install degrades gracefully — the agent is always instructed to prefer the live CLI and docs over the bundled copies.

​
Related documentation

Quickstart

Bootstrap a project with npm create agentmark — skill included

AI editor integration

Wire the docs MCP so your editor can query AgentMark documentation

MCP trace server

Query live traces and sessions from your editor

CLI commands

The command surface the skill drives

​
Have Questions?

We’re here to help! Choose the best way to reach us: