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.

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>/.

Install

bun install -g @hasna/skills

skills login

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.