skills.md
Are you an agent?

Agent Integrations

Use the public @hasna/skills MCP server with your agent host. Complete Installation first so the skills-md profile holds your Skills.md credential.

Select the customer profile

Configure the host to run skills-mcp with this environment:

{
  "HASNA_PROFILE": "skills-md",
  "HASNA_SKILLS_API_URL": "https://skills.md"
}

The equivalent terminal command is:

MCP server
HASNA_PROFILE=skills-md HASNA_SKILLS_API_URL=https://skills.md skills-mcp

These values select the saved profile; do not put a provider key or database credential in the MCP configuration. Keep a separate named profile for an internal or self-hosted server.

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 and add the profile and API environment above. Registration alone does not select a credential profile. 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 initial reviewed hosted skill is blog-article. Local OSS tools and hosted customer operations share the public package, but each operation retains its own execution target and supported capabilities.

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