> For the complete documentation index, see [llms.txt](https://docs.doma.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.doma.xyz/agentic-commerce/skills.md).

# Skills

A **Doma skill** is a markdown file (`SKILL.md`) plus optional supporting files (`examples/`, `reference/`) hosted at a public URL. Once installed in an AI agent, the skill becomes the agent's instruction manual for a specific kind of task, buying domains, swapping tokens, paying for a registration.

Skills are **portable**: the same `SKILL.md` works in Claude Code, Cursor, Codex CLI, Gemini, OpenCode. They are **stateless on the publisher side**: once installed, the skill runs locally in the agent and only calls back to public APIs and CLIs.

## The `SKILL.md` format

A `SKILL.md` is YAML frontmatter followed by Markdown body. The frontmatter declares metadata; the body contains the workflow logic the agent follows.

```markdown
---
name: my-skill
description: >
  One-line summary of what this skill does. Trigger on: phrase one,
  phrase two, phrase three.
license: MIT
metadata:
  author: <publisher>
  version: "1.0.0"
compatibility: Requires Node.js 18+ and the foo CLI.
allowed-tools: Bash(foo *), Bash(npx -y foo *)
argument-hint: [domain-name]
---

# My Skill

Body markdown describing the workflow the agent follows when triggered.

## Rules
1. Always ask before spending.
2. ...

## Flow
### 1. Setup
...
```

| Frontmatter field  | Purpose                                                                              |
| ------------------ | ------------------------------------------------------------------------------------ |
| `name`             | Canonical skill ID. Must match the install path slug.                                |
| `description`      | One-line summary plus the **trigger phrases** the agent matches against user intent. |
| `license`          | SPDX license identifier (MIT recommended for public skills).                         |
| `metadata.author`  | Publisher name.                                                                      |
| `metadata.version` | SemVer string.                                                                       |
| `compatibility`    | Required tooling on the user's machine.                                              |
| `allowed-tools`    | Subset of agent tools the skill is permitted to invoke.                              |
| `argument-hint`    | Slot template for arguments the user may pass.                                       |

## Trigger phrases

The `description` field is how the agent decides to load a skill for a given user prompt. Phrases like "buy tokens", "swap on Uniswap", "make an offer" are matched against installed skills' descriptions; the best match wins.

For Doma's published skills, the trigger phrases are documented on each skill's reference page below.

## Currently published skills

| Skill                                                          | What it does                                                                          | Manifest URL                                                   |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| [Secondary Sales](/agentic-commerce/skills/secondary-sales.md) | Buy listed domains via Doma's marketplace (Seaport NFT)                               | `https://doma.xyz/.well-known/skills/secondary-sales/SKILL.md` |
| [Trade Tokens](/agentic-commerce/skills/trade-tokens.md)       | Buy / sell fractional domain tokens (Launchpad bonding curve, Uniswap V3, sellOnFail) | `https://doma.xyz/.well-known/skills/trade-tokens/SKILL.md`    |
| [MPP](/agentic-commerce/skills/mpp.md)                         | Pay HTTP 402 endpoints for domain registration via the Machine Payments Protocol      | `https://doma.xyz/.agents/skills/doma-mpp/SKILL.md`            |

## Adding your own skill

If you publish your own AgentRoot zone, you can include a `skill` record pointing to your own `SKILL.md`. See [Publish Your Own](/agentic-commerce/agentroot/publish-your-own.md#optional-host-skillmd-files-alongside-your-zone).

## What's next

* [Secondary Sales](/agentic-commerce/skills/secondary-sales.md): buy domains.
* [Trade Tokens](/agentic-commerce/skills/trade-tokens.md): swap fractional tokens.
* [MPP](/agentic-commerce/skills/mpp.md): payment-gated registration.
* [AgentRoot → Publish Your Own](/agentic-commerce/agentroot/publish-your-own.md): author and publish your own skill.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.doma.xyz/agentic-commerce/skills.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.