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.

Overview

skills.md is a remote skill platform for AI agents. The agent discovers a skill, asks for a quote when the run costs money, sends inputs to the hosted runtime, and receives artifacts back in the workspace.

What you can do

StartQuickstart

Install, sign in, register agents, run a skill, and inspect the exported files.

UseFind and run skills

Search the registry, inspect documentation, quote premium work, and run skills by name.

OperateUnderstand pricing

See how free skills, premium quotes, balances, receipts, and refunds fit together.

OperateOperate premium runs

Track async jobs, approvals, receipts, and generated artifacts.

Mental model

  1. Install the CLI once on the machine.
  2. Register the MCP server with the agents you use.
  3. Discover skills from the remote registry.
  4. Run a skill by name.
  5. Download outputs under .skills/exports/<skill>/<run-id>/.
First install
bun install -g @hasna/skills && skills auth signup

Local folder contract

The .skills folder is a workspace for runtime state and outputs, not a copy of the skill catalog.

FolderPurpose
.skills/exports/<skill>/<run-id>/Files generated by a skill run.
.skills/runs/<run-id>/Local metadata, logs, and receipts for a run.
.skills/pins/Local preferences for commonly used remote skills.
.skills/cache/Safe cache entries that can be rebuilt.

Next step

Follow the quickstart, then connect your agent through MCP.

bun install -g @hasna/skills