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.

---
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	Buy listed domains via Doma's marketplace (Seaport NFT)	https://doma.xyz/.well-known/skills/secondary-sales/SKILL.md
Trade Tokens	Buy / sell fractional domain tokens (Launchpad bonding curve, Uniswap V3, sellOnFail)	https://doma.xyz/.well-known/skills/trade-tokens/SKILL.md
MPP	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.

What's next

• Secondary Sales: buy domains.

• Trade Tokens: swap fractional tokens.

• MPP: payment-gated registration.

• AgentRoot → Publish Your Own: author and publish your own skill.