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.