// publish_skills
Publishing Skills
Publish reusable skill files that teach AI coding agents how to perform specific tasks. Skills are Markdown documents with structured frontmatter that agents load as context when working on relevant problems.
// prerequisites
- A domain you control (e.g.
devkit.tools)
- One or more skill files in SKILL.md format
- A web server to host the skill index and files
- DNS access to add TXT records
1Create your zone file
A skill record points to an index.json that lists all available skills. Start with the zone file:
// agentroot.json
{
"domain": "devkit.tools",
"records": [
{
"id": "react-patterns",
"type": "skill",
"name": "React Best Practices",
"description": "Coding patterns, component architecture, and testing strategies for React apps",
"index": "https://devkit.tools/skills/react-patterns/index.json"
}
]
}
Now create the index.json that lists individual skill files:
// skills/react-patterns/index.json
{
"name": "React Best Practices",
"version": "1.2.0",
"skills": [
{
"slug": "component-architecture",
"title": "Component Architecture",
"file": "component-architecture.md",
"triggers": ["react component", "component structure", "props pattern"]
},
{
"slug": "testing-strategy",
"title": "Testing Strategy",
"file": "testing-strategy.md",
"triggers": ["react test", "testing library", "component test"]
}
]
}
Each skill is a Markdown file with YAML frontmatter:
# skills/react-patterns/component-architecture.md
---
title: Component Architecture
triggers:
- react component
- component structure
- props pattern
version: 1.2.0
---
# Component Architecture
When building React components, follow these patterns:
1. **Prefer composition over inheritance** ...
2. **Use TypeScript interfaces for props** ...
3. **Extract hooks for shared logic** ...
Your directory structure should look like:
# Directory layout
skills/react-patterns/
index.json
component-architecture.md
testing-strategy.md
2Host the zone file
Upload the zone file, index, and all skill Markdown files to your domain:
# Files to deploy
https://devkit.tools/.well-known/agentroot.json
https://devkit.tools/skills/react-patterns/index.json
https://devkit.tools/skills/react-patterns/component-architecture.md
https://devkit.tools/skills/react-patterns/testing-strategy.md
All files must be publicly accessible. Skill Markdown files should be served as text/markdown or text/plain.
3Add the DNS record
# Add this TXT record to your DNS
_agentroot.devkit.tools TXT "v=ar1 zone=https://devkit.tools/.well-known/agentroot.json"
4Submit to AgentRoot
$ npx agent-root publish devkit.tools
Or via the API:
$ curl -X POST https://agentroot.io/api/zones \
-H "Content-Type: application/json" \
-d '{"domain": "devkit.tools"}'
5Verify it worked
$ npx agent-root search "react patterns" --type skill
# Expected output:
devkit.tools/react-patterns skill React Best Practices
skills: component-architecture, testing-strategy
Install the skill into a coding tool to confirm the files resolve:
$ npx agent-root install devkit.tools/react-patterns --tool claude
# Downloads skill files to ~/.claude/skills/devkit.tools/react-patterns/
Skill triggers determine when an AI agent automatically loads the skill. Choose triggers that match the natural language developers use when asking for help with that topic.
// next_steps