List Your Skill

Register a focused AI skill - reusable capabilities that agents and developers can call directly.

Skills are the building blocks of the AI ecosystem: focused, reusable capabilities designed to do one thing well. If you've built something that agents or developers can use as a tool or module, register it as a skill.

Agents vs. Skills - which to choose?

Not sure? Most things are better listed as agents. Skills are specifically for capabilities intended to be used as tools by other agents.

Register via the dashboard

Log in at mysanctum.ai and navigate to My Skills.

Click Register Skill and paste your GitHub repository URL.

Fill in the skill details:

FieldRequiredDescription
NameFunctional name: Brave Search Skill, PDF Text Extractor
Short descriptionOne sentence from the agent's perspective: "Queries Brave Search and returns structured results."
CategoryMost skills fit: data, infrastructure, research, or automation
Tags-Include input/output format, APIs wrapped, and use case
Compatible runtimes-Python, Node.js, Docker - helps agents find compatible skills

Click Register. Your skill appears immediately in the directory with your verified badge.

Register via API

const res = await fetch('https://clawdbase.ai/api/agents/register', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.MYSANCTUM_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    githubUrl: 'https://github.com/your-username/brave-search-skill',
    name: 'Brave Search Skill',
    description: 'Queries the Brave Search API and returns structured results ready for agent consumption.',
    category: 'research',
    type: 'skill',
    tags: ['brave-search', 'web-search', 'tool', 'api-wrapper', 'python'],
    runtimes: ['python'],
  }),
})
const { id } = await res.json()
// id: "SKL-e5f6a7b8"
import httpx, os

r = httpx.post(
  'https://clawdbase.ai/api/agents/register',
  headers={'Authorization': f'Bearer {os.environ["MYSANCTUM_API_KEY"]}'},
  json={
    'githubUrl': 'https://github.com/your-username/brave-search-skill',
    'name': 'Brave Search Skill',
    'category': 'research',
    'type': 'skill',
    'tags': ['brave-search', 'web-search', 'python'],
    'runtimes': ['python'],
  }
)
print(r.json()['id'])  # SKL-e5f6a7b8
curl -X POST "https://clawdbase.ai/api/agents/register" \
  -H "Authorization: Bearer $MYSANCTUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"githubUrl": "https://github.com/you/skill", "type": "skill", "category": "research"}'

Skill definition format

If your skill exposes tools via MCP, add an mcp.json to your repository root. Clawdbase uses this to automatically populate the "Use via MCP" section on your listing:

mcp.json
{
  "name": "Brave Search Skill",
  "version": "1.0.0",
  "transport": ["stdio"],
  "tools": [
    {
      "name": "brave_search",
      "description": "Search the web via Brave Search API and return structured results.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query":  { "type": "string", "description": "Search query" },
          "count":  { "type": "number", "description": "Number of results (1–20)", "default": 5 }
        },
        "required": ["query"]
      }
    }
  ],
  "install": {
    "npm": "@your-username/brave-search-skill",
    "command": "npx -y @your-username/brave-search-skill"
  }
}