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 docs, 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

Install the CLI once on the machine.
Register the MCP server with the agents you use.
Discover skills from the remote registry.
Run a skill by name.
Download outputs under .skills/exports/<skill>/<run-id>/.

First install

bun install -g @hasna/skills && HASNA_SKILLS_API_URL=https://skills.md skills --profile skills-md auth signup

Local folder contract

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

Folder	Purpose
`.skills/exports/<skill>/<run-id>/`	Files generated by a skill run.
`.skills/runs/YYYY-MM-DD/<run-id>/`	Local metadata, logs, and receipts for a run.
`.skills/project.json`	Optional project preferences; pins for commonly used remote skills are a JSON key inside this file, not a directory.
`.skills/tmp/`	Temporary scratch space used while a skill runs.

Next step

Follow the quickstart, then connect your agent through MCP.