SKILL.md and llms.txt
Teach a coding agent the whole workflow in one file, and give any model the docs as Markdown with llms.txt, llms-full.txt and per-page Markdown.
Last updated
On this page
Agents work best from short, precise instructions they can fetch themselves. Everything an agent needs is published as plain Markdown at stable URLs.
SKILL.md
https://primaryapi.com/SKILL.md is an agent skill: a Markdown file with a short YAML header (name, description) and the instructions an agent needs to use the API well. It covers:
- what the service is and how prices work,
- setup with an existing key, or minting a trial key with
POST /agent/signup, - the discover, inspect, quote and run loop, over REST and over MCP,
- keeping responses small with
fields,max_itemsand free re-reads, - durable calls and polling, idempotent retries,
- what to do with each error, including relaying the claim link on
402 trial_cap_reached, - never printing or logging the key.
https://primaryapi.com/agent-onboarding/SKILL.md is a shorter variant that only covers getting a working key and connecting a client: useful when the agent should set things up and stop.
Both files are generated from the same catalog and docs as this site on every deploy, so they always match the live API.
Give it to your agent
The quickest way is to ask, in plain words:
Set up https://primaryapi.com/SKILL.mdAgents that support skills can also keep a local copy. For Claude Code, save it as a personal skill (available in every project) or a project skill (shared through the repository):
# personal
mkdir -p ~/.claude/skills/primaryapi
curl -sS https://primaryapi.com/SKILL.md -o ~/.claude/skills/primaryapi/SKILL.md
# project
mkdir -p .claude/skills/primaryapi
curl -sS https://primaryapi.com/SKILL.md -o .claude/skills/primaryapi/SKILL.mdOther agents that read Markdown instructions (an AGENTS.md file, a rules file, a system prompt) can be pointed at the same URL. Re-download it now and then to pick up new guidance.
llms.txt and llms-full.txt
Following the llms.txt convention:
| URL | Contents |
|---|---|
https://primaryapi.com/llms.txt | A short index: what the service is, links to every guide and to the API reference, grouped by platform. Small enough to read on every task. |
https://primaryapi.com/llms-full.txt | Everything in one file: every guide and every API reference page as Markdown. Large; fetch it when an agent needs the full picture offline. |
Any page as Markdown
Every page of these docs has a Markdown twin at the same path under /docs/md: /docs/quickstart is also at https://primaryapi.com/docs/md/quickstart, and the API index at https://primaryapi.com/docs/md/api-reference. The Copy page button at the top of each page copies that Markdown, ready to paste into a chat. Data tables such as the error codes and the API list are rendered as Markdown tables there, with the same values as the HTML page.
Machine-readable contracts
| URL | Contents |
|---|---|
GET https://api.primaryapi.com/v1/apis/{sku} | One API's full contract: JSON Schemas for input and output, examples, price and measured 30-day health. |
GET https://api.primaryapi.com/v1/catalog | Every callable API with pricing, health and availability, refreshed at most every 60 seconds. |
GET https://api.primaryapi.com/openapi.json | An OpenAPI 3.1 document generated from the catalog, with one POST /v1/run/{sku} operation per API. Feed it to code generators or tools that import OpenAPI. |
None of these needs a key.