What is an agent skill?
An agent skill is a self-contained installable package that gives an AI agent specialized knowledge of a specific API, service, or workflow.
The agentskills.io specification defines the manifest format. A skill includes:
- API schemas and tool definitions for the agent to invoke
- Example prompts showing how to use the API
- Operational instructions and edge-case guidance
- Configuration templates for client integration
- Optional: pre-trained context the agent loads before tool calls
Skills install with one command: npx skills add <repo> -g --yes. The CLI fetches the manifest, validates it, and registers it with all detected agent clients (Claude Code, Cursor, Codex CLI, Gemini CLI, and others that implement the spec).
Skills vs MCP servers
These are complementary, not alternative:
- MCP server — a running process the agent calls at runtime to invoke tools and fetch live data. Stateful, networked, authenticated.
- Skill — static knowledge the agent reads into context before any tool call. API docs, example workflows, prompt templates.
Most modern dev-tool products ship both: an MCP server for live tool execution, and a skill for the surrounding knowledge needed to use the MCP correctly. Codex, Helius, and Alchemy all publish public skills repositories.
Hive's roadmap includes a hive-intel/skills repo for crypto-data workflows.