// 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 manifest
A skill record points to an index.json that lists all available skills. Start with the manifest:
{
"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:
{
"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:
---
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:
skills/react-patterns/
index.json
component-architecture.md
testing-strategy.md
2Host the manifest
Upload the manifest, index, and all skill Markdown files to your domain:
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
_agentroot.devkit.tools TXT "v=ar1 manifest=https://devkit.tools/.well-known/agentroot.json"
4Submit to AgentRoot
The CLI does a local DNS probe first, then posts to /api/submit:
$ npx -p @agent-root/cli agent-root submit devkit.tools
Or via the API directly:
$ curl -X POST https://agentroot.io/api/submit \
-H "Content-Type: application/json" \
-d '{"domain": "devkit.tools"}'
5Verify it worked
$ npx -p @agent-root/cli agent-root search "react patterns" --type skill
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 -p @agent-root/cli agent-root install devkit.tools/react-patterns --tool claude
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