Quickstart

Every skill on emdly is a plain .md file with a stable URL. Install one into Claude Code, or connect the whole catalog over MCP.

# install one skill into ./skills
npx emdly add opsmith/jira-ticket-scorer

# or connect the catalog to Claude
claude mcp add --transport http emdly https://mcp.emdly.com

Raw endpoints

Each document serves raw Markdown at a predictable path. Unversioned URLs always return the latest; pin a version when exact wording matters.

GET https://emdly.com/raw/{owner}/{skill}.md        → latest
GET https://emdly.com/raw/{owner}/{skill}@v12.md    → pinned version

200 OK · content-type: text/markdown; charset=utf-8

REST API

Everything the site does, a script can do. Authenticate with a bearer token from your agent’s configuration (My agent → Configuration).

GET    /v1/skills?category=code-review&sort=trending
GET    /v1/skills/{owner}/{skill}
POST   /v1/skills                    → submit for review
PUT    /v1/skills/{owner}/{skill}    → new version
POST   /v1/agents/{agent}/skills     → install to your agent

MCP server

The emdly MCP server exposes the catalog as tools, so agents can find and load skills themselves.

search_skills(query, category?)   → ranked results
get_skill(owner/skill, version?)  → the markdown body
install_skill(owner/skill)        → adds to your agent

# with your agent bearer token — private Brain memory
brain_list(folder?)               → your files
brain_search(query)               → files + matching lines
brain_get(name)                   → the markdown body
brain_write(name, body, mode?)    → create / replace / append, versioned

Publishing & review

Submitted skills run automated checks (Markdown lint, license, prompt-injection scan) and then queue for human review. Approved skills are published with a version history; every update goes through the same pipeline.

Frequently asked

What is an agent skill?

A Markdown file that tells an AI agent how to do one job: when to use it, the rules, and the exact output format. Skills say how to work; your private Brain files say what is true in your context.

How do I install a skill into Claude Code?

Run npx emdly add owner/skill to copy the .md into ./skills, or add the emdly MCP server once and let Claude search and load skills itself.

Do I need an account to install?

No. Raw URLs, the CLI and MCP search/get work without signing in. Upvoting, publishing and the hosted agent need a Google or GitHub sign-in.

What does “Security checked” mean?

The published version passed Markdown lint, a license check and a prompt-injection scan, the AI safety scan came back clean, and a human reviewer approved it. It reduces risk; it does not replace reading the file.

Can I pin a version?

Yes — use @v12 in the raw URL, or the version argument of get_skill over MCP. Unversioned URLs always return the latest approved version.

Is there a machine-readable version of this site?

Yes: /llms.txt and /llms-full.txt, and any public page as Markdown by appending .md or sending Accept: text/markdown.