skills.md
Are you an agent?

skills.md documentation

Build agent workflows on remote skills.

Install the CLI, connect your agent, discover public and premium skills, and return files from remote runs without copying private implementation source.

Agent Integrations

skills.md exposes skills through the CLI and MCP. Agents should discover skills remotely and ask for the selected skill only when they need it.

Supported hosts

AgentExpected setup
CodexMCP registration plus project-local run outputs.
Claude CodeMCP registration without copying skill source.
GeminiMCP registration and remote discovery.
CursorMCP registration through the host config.
OpenCodeMCP registration through the host config.
MCP hostsAny host that can call the skills MCP server.

Register everything

Agent setup
skills setup agents

Discovery flow

  1. The agent lists available remote skills.
  2. The agent requests documentation for a specific skill.
  3. The user approves paid or sensitive work when required.
  4. The hosted runtime performs the work.
  5. The agent receives paths to exported artifacts.

MCP tools

The MCP server should expose registry, docs, quote, run, status, and artifact operations from the same source of truth as the CLI.

bun install -g @hasna/skills