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.

Quickstart

This path gets a new machine from zero to a remote skill run without copying skill source into agent folders.

Install the CLI

Install the public package once on the machine.

Install
bun install -g @hasna/skills

Create or reuse an account

Sign in with the passwordless OTP flow. The same command works for first-time users and returning users.

Sign in
skills auth signup

Register agent integrations

Register the MCP server for supported hosts from the project where you want agents to use skills.

Register agents
skills setup agents

Find a skill

Search by task, inspect the contract, and quote premium work before running it.

Search
skills search pdf
Inspect
skills info pdf-to-markdown
Quote
skills quote pdf-to-markdown --input ./report.pdf

Run and inspect outputs

Run by skill name. Outputs materialize under .skills/exports/<skill>/<run-id>/.

Run
skills run pdf-to-markdown --input ./report.pdf
List exports
find .skills/exports/pdf-to-markdown -maxdepth 2 -type f

What success looks like

After setup, agents discover skills through MCP, request the selected skill contract only when needed, ask for approval for paid work, and return generated files in the workspace.

bun install -g @hasna/skills