Documentation

Build with the OpenAgentSkill registry.

Learn how to discover, install, submit, and expose skills through agent-friendly APIs.

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-run

After 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=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.md file with name and description frontmatter
  3. Include clear documentation and usage examples
  4. 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.