Skip to main content
Doctorine

Agent Skills

Package the practical knowledge an agent needs to use your API well.

Generate an open SKILL.md package with focused operation references, authentication, retries, pagination, errors, executable recipes, and source provenance.

Start free Inspect the package anatomy
payments-api-skill Conformance passed

# Payments API

Use this skill when

Creating charges, handling refunds, or verifying webhook signatures.

Before the first request

  • Use a scoped service token.
  • Send an idempotency key for writes.
  • Follow retry guidance for 429 and 5xx responses.

Give agents the operating knowledge the schema leaves out.

Focused guidance covers the decisions, recovery paths, and multi-step workflows that raw operations cannot explain.

  • Open SKILL.md plus focused references

  • Executable HTTP recipes and API sidecar

  • Portal, CLI, and llms.txt discovery

A small router with the right details behind it.

SKILL.md tells the agent when and how to use the package. Focused references and recipes keep operation detail available without forcing the whole API into every context window.

SKILL.md
Scope, triggers, decision guidance, and links to deeper material.
references/
Authentication, operations, pagination, retries, and typed error behavior.
recipes/
Executable HTTP workflows for common, multi-step developer tasks.
api.json
A machine-readable sidecar tied to the released operation model.
provenance.json
The source and generator identity behind the package.

Practical behaviors a schema does not explain.

Authentication setup, idempotency, retry decisions, pagination, error recovery, and multi-step recipes turn an operation list into guidance an agent can apply.

  • Know when to stop and ask

    References can name required credentials, irreversible actions, and project-specific decisions.

  • Follow the supported request shape

    Executable HTTP recipes derive from the same operation model as docs and SDK examples.

  • Keep large APIs navigable

    Large packages split into linked resource files without losing discoverability from the root Skill.

Two Skills, built for different jobs.

Doctorine can package operating knowledge for your API. Separately, it can install Doctorine’s own workspace guidance for agents that help maintain your documentation.

Your API Skill

Generate an inspectable SKILL.md package for your customers’ agents, then distribute it through the portal or as a downloadable archive. 

❯ doctorine sdk generate --target skill
Conformance passed
Wrote payments-api-skill.zip

Portal discovery
  /llms.txt
  /agent-skill.zip

Doctorine’s workspace Skill

Install Doctorine’s documentation-authoring Skill for Claude. Add the optional AGENTS.md block when other coding agents should receive the same repository guidance. 

❯ doctorine mcp skills install --agents-md
Installed Doctorine Skill for Claude
Updated ./AGENTS.md

Open enough to fit more than one agent workflow.

Doctorine installs its workspace Skill under Claude’s Skill directory. Other agents can receive the documentation workflow through the optional, safely merged AGENTS.md block without pretending they implement the same Skill protocol.

  • Claude Code Doctorine workspace Skill
  • Repository instructions Any agent that reads AGENTS.md

The package follows the same released API model.

Hosted generation, local generation, portal discovery, and conformance checks stay tied to one source revision.

  • SDK Studio

    Generate the Skill beside supported SDK targets and inspect the router, references, recipes, API sidecar, and conformance result.

  • CLI

    Build or drift-check the package locally with the same released API model used by hosted generation.

  • Published portal

    Eligible public portals expose the Skill archive and advertise it through llms.txt so agents can discover the released package.

Inspect every file the agent receives.

Open Markdown, executable recipes, the API sidecar, and provenance make the package reviewable before distribution.

Open files
The output is an inspectable SKILL.md package, not a proprietary prompt blob or a claim that every model will behave identically.
Structural conformance
Package validation checks routing, references, recipes, sidecar structure, and size boundaries before the artifact is marked ready.
Distribution boundary
Doctorine produces downloadable artifacts and portal discovery. It does not claim publication to a third-party Skill registry.

Give the agent operating knowledge, not another documentation dump.

Generate the package from a released API model, inspect every file, and test it in the client workflows your team uses.

Generate an Agent Skill