Your domain is your identity. Add a DNS record, host your SKILL.md files, and every AI tool on the internet can find and install your skills. No accounts. No approval. Just DNS.
AgentRoot supports two record types. You can use both on the same domain.
Agent
_agent TXT record
An autonomous AI entity — it has memory, makes decisions, and acts. Use for things that think.
Skills
_skill TXT record + SKILL.md files
Callable tools and APIs that agents can use. Published as SKILL.md files — the open standard.
I just have a URL
No DNS setup needed
Paste a link to any publicly-hosted SKILL.md file. Listed as unverified — no DNS required.
// step 2
Build your DNS record
Fill in the fields below. Copy the generated record and add it to your DNS provider as a TXT record.
This URL points to your index.json file, which lists your skills. Each skill links to a SKILL.md file. See step 3 below for the format.
Direct link to a single SKILL.md file. GitHub blob URLs are auto-converted to raw URLs. The file must have a name (and optionally description) in YAML frontmatter or a markdown table.
DNS propagation usually takes minutes, sometimes up to 24 hours.
Field reference
Field
Required
Description
v
required
Always agent1
name
required
Short display name, no spaces
caps
required
Comma-separated capabilities, lowercase
endpoint
optional
URL where this agent can be called
proto
optional
Protocol: rest, a2a, mcp, openapi, etc.
desc
optional
Description (escape spaces with \ )
card
optional
URL to agent-card.json
Field
Required
Description
v
required
Always skill1
index
one of
URL to your skills index.json (for multiple skills)
skill_md
one of
URL to a single SKILL.md file (GitHub blob URLs auto-converted)
Provide either index or skill_md, not both.
// step 3 — for skills
The SKILL.md open standard
If you're publishing skills, each skill is a directory with a SKILL.md file. This is the open standard used across the agent ecosystem — write once, works everywhere.
Claude CodeOpenAI CodexGemini CLIGitHub CopilotCursorWindsurf
{
"schema": "agent-skills/1.0",
"domain": "yourdomain.com",
"skills": [
{
"id": "my-skill",
"name": "My Skill",
"description": "What this skill does in one sentence",
"skill_md": "https://yourdomain.com/.agents/skills/my-skill/SKILL.md"
}
]
}
SKILL.md format
---
name: my-skilldescription: What this skill does and when to trigger it
---
# My Skill
Instructions for how the agent should use this skill.
## When to use
Use this skill when the user wants to...
## API EndpointsGET https://yourdomain.com/api/search?q=<query>
## Example
...
Publishing agents only? Skip this step — agents don't need SKILL.md files. The DNS TXT record is enough.
// step 4
Submit your domain
Once your DNS record is set (and your index.json is hosted, if publishing skills), tell AgentRoot to look you up.
# Or submit via the API
curl -X POST https://agentroot.io/api/submit \
-H "Content-Type: application/json" \
-d '{"domain": "yourdomain.com"}'
Must be a publicly accessible SKILL.md file with name and description — either as YAML frontmatter or in a markdown table.
# Or submit via the API
curl -X POST https://agentroot.io/api/submit-url \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/SKILL.md"}'
Want the green checkmark? Add a DNS TXT record to prove you own this domain. Takes 2 minutes. See step 2.
// step 5
What happens next
Once submitted, your agent or skills are immediately discoverable.
✓
Instant indexing Your domain appears in the public registry immediately after submission.
✓
API-discoverable Other agents and developers can find you via GET /api/discover, /api/find-skills, or the registry UI.
✓
Re-verified automatically AgentRoot re-checks your DNS record periodically. Your DNS is always the source of truth — update or remove it anytime.
✓
Installable everywhere Anyone can install your skills in Claude Code, Codex CLI, Gemini CLI, and more — because they follow the open SKILL.md standard.
// subdomains
Multiple agents per domain
Use subdomains to register multiple agents or skills. Submit each separately.
_agent.example.com → main agent
_agent.radar.example.com → signal intelligence agent
_skill.api.example.com → public API skills