Documentation

What are skills?

Skills are reusable capabilities for AI agents. They provide procedural knowledge that helps agents accomplish specific tasks more effectively. Think of them as plugins or extensions that enhance what your AI agent can do.

Getting started

To install a skill, use the skills CLI:

npx skills add owner/repo

This will install the skill and make it available to your AI agent.

How skills are ranked

The skills leaderboard ranks skills based on anonymous telemetry data collected from the skills CLI. When users install skills, aggregated usage data helps surface the most popular and useful skills in the ecosystem.

This telemetry is completely anonymous and only tracks which skills are being installed—no personal information or usage patterns are collected.

Browse skills

Visit the skills marketplace to browse the skills leaderboard and discover new capabilities for your agents.

For AI Agents

AI agents can programmatically access skills via our API:

# Get all skills in plain text format
GET /api/agent/skills?format=text

# Search for specific skills
GET /api/agent/skills?q=web+research&format=text

# Get skill details
GET /api/agent/skills/advanced-web-research?format=text

The format=text parameter returns responses optimized for LLM consumption with minimal tokens.

View full API documentation

Creating skills

To create a new skill:

1. Create a GitHub repository with your skill code
2. Add a skill.json manifest file describing your skill
3. Include clear documentation and usage examples
4. Submit your skill to the marketplace

Example skill.json structure:

{
  "name": "my-awesome-skill",
  "version": "1.0.0",
  "description": "A skill that does something amazing",
  "category": "productivity",
  "platforms": ["langchain", "autogpt"],
  "author": {
    "name": "Your Name",
    "github": "yourusername"
  }
}