skills.md

Agent Integrations

Use the public @hasna/skills MCP server with your agent host. Complete Installation first so skills login has saved your skills.md credential.

Run the MCP server

Configure the host to run skills-mcp. It uses the account you signed in with, so the MCP configuration needs no API key, provider key or database credential.

MCP server
skills-mcp

For a self-hosted server, sign in with skills login --url https://<your-host> first. Keep an internal or self-hosted connection as a separate host entry.

Register with a host

The public CLI supports MCP registration for Codex, Claude Code, Antigravity, Pi, Cursor, OpenCode, Windsurf and other compatible hosts. Inspect the installed client's options before selecting a host:

Registration options
skills mcp --help

When using skills mcp --register <agent>, check that host's generated server configuration. Preserve any existing internal Skills connection as a separate host entry.

Hosted work

  1. Discover tools through MCP tools/list, then call get_server_capabilities and list_remote_skills for the selected server.
  2. Quote the requested input with quote_skill and show the user the credit cost.
  3. After approval, use run_skill with remote: true and the approved maxCredits. Reuse an idempotency key only for identical input.
  4. Read get_run_status, get_run_logs and list_run_artifacts for the same run.
  5. Download verified output through MCP or the CLI, then show the resulting file paths to the user.

The hosted catalog reports which skills can run on skills.md. Local OSS tools and hosted customer operations share the public package, but each operation retains its own execution target and supported capabilities.