Documentation
Build with the OpenAgentSkill registry.
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
Resolve and inspect a skill before running the source installer:
npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install <skill-slug> --agent codex --dry-runAfter reviewing the repository and policy, rerun with --yes. Blocked skills are refused and verified install evidence is recorded only after the installer succeeds.
How skills are ranked
Verified installs are counted only when a compatible agent or integration reports an idempotent install outcome receipt. Install-command copies and verified installs are tracked as separate signals.
Direct GitHub clones and third-party installer runs are not observable unless they submit a receipt. Receipts contain the skill, agent label, install result, and optional aggregate quality fields; they do not require personal identity.
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
# Filter for production-ready trust signals
GET /api/agent/skills?trust=production&format=text
# Get skill details
GET /api/agent/skills/advanced-web-research?format=textThe format=text parameter returns responses optimized for LLM consumption with minimal tokens.
Creating skills
To create a new skill:
- Create a GitHub repository with your skill code
- Add a SKILL.md file with name and description frontmatter
- Include clear documentation and usage examples
- Submit your skill to the marketplace
Example SKILL.md structure:
---
name: my-awesome-skill
description: A skill that does something amazing
version: 1.0.0
category: productivity
---
# My Awesome Skill
Explain when an agent should use the skill and the steps it should follow.Security
We perform routine security audits to assess skills and their contents for malicious content. However, we cannot guarantee the quality or security of every skill listed on openagentskill.com.
We encourage you to review skills before installing and use your own judgment. To report security issues, please contact our security team.