emdly

Use this FIRST, before any non-trivial task, to find a ready-made skill in the emdly catalog (reviewed Markdown playbooks for AI agents). Query with 1–3 short keywords naming the kind of work (e.g. "code review", "jira", "seo audit"); words are matched independently, so a sentence works too. If the result is empty, retry with a single noun, or send an empty query for the top skills. Returns ranked skills with their owner/name id, category, description and install command.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "1–3 short keywords for the kind of work (each word is matched on its own against name, description, tags, category and author). Empty = the most popular skills.",
      "type": "string"
    },
    "category": {
      "description": "Optional category slug or name, e.g. code-review.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

Read a skill's Markdown to inspect it (does not install anything). To install, call install_skill — it returns the file plus the exact path to write it to. Pass version to pin one.

{
  "type": "object",
  "properties": {
    "skill": {
      "description": "owner/name, e.g. opsmith/jira-ticket-scorer",
      "type": "string"
    },
    "version": {
      "description": "Pin a version number; omit for latest.",
      "type": "integer"
    }
  },
  "required": [
    "skill"
  ]
}

Install a skill into the agent you are running in. Returns the complete skill file and the exact path to write it to — YOU must then create that file verbatim (Claude Code: ~/.claude/skills/<name>/SKILL.md, so it becomes available as /<name> in every project; other agents: ./skills/<name>.md) and tell the user where it is. Counts the install. Use target=hermes for Hermes Agent, target=generic for any other agent, scope=project to keep a skill inside the current Claude Code project only (.claude/skills, committable for the team). When emdly agent hosting is enabled and you have a hosted agent, pass agent= to install there instead.

{
  "type": "object",
  "properties": {
    "skill": {
      "description": "owner/name, e.g. opsmith/jira-ticket-scorer",
      "type": "string"
    },
    "target": {
      "description": "Where the file goes: claude-code (default) → ~/.claude/skills/<name>/SKILL.md; hermes → ~/.hermes/skills/<category>/<name>/SKILL.md; generic → ./skills/<name>.md.",
      "enum": [
        "claude-code",
        "generic",
        "hermes"
      ],
      "type": "string"
    },
    "scope": {
      "description": "Claude Code only: user (default, ~/.claude/skills, available in every project) or project (.claude/skills in the current project — only when the user asks for a project-local install).",
      "enum": [
        "project",
        "user"
      ],
      "type": "string"
    },
    "agent": {
      "description": "Hosted agent name (only when emdly agent hosting is enabled and you have one).",
      "type": "string"
    }
  },
  "required": [
    "skill"
  ]
}

Curated bundles of skills. Without an argument: list the available collections (slug, name, size). With a slug: the skills in that collection, in order — then call install_skill for each one the user wants (usually all).

{
  "type": "object",
  "properties": {
    "collection": {
      "description": "Collection slug, e.g. laravel-starter. Omit to list all collections.",
      "type": "string"
    }
  }
}

Submit a skill to emdly for review (needs sign-in). Creates it under your account — or a new version if you already own one with this name — runs the automated checks and the AI safety scan, and queues it for a human reviewer. Nothing is published by this tool; you get the check results back. The body must be a complete Markdown skill with a title and a "## License" section (MIT recommended).

{
  "type": "object",
  "properties": {
    "name": {
      "description": "kebab-case skill name, unique within your account",
      "type": "string"
    },
    "body": {
      "description": "Full Markdown: # title, when to use, rules, output format, ## License",
      "type": "string"
    },
    "category": {
      "description": "Category name; required for a new skill.",
      "type": "string"
    },
    "note": {
      "description": "Release note when submitting a new version of an existing skill.",
      "type": "string"
    }
  },
  "required": [
    "name",
    "body"
  ]
}

List the files in your Brains (named sets of private Markdown memory), including brains shared with you. Needs your agent bearer token. Returns the brain, your role in it, name, folder, size, whether the file is in the agent context and shared with members, and when it changed.

{
  "type": "object",
  "properties": {
    "brain": {
      "description": "Optional brain name; for a brain shared with you, owner-handle/name (e.g. jan/Team). Omit to list every brain.",
      "type": "string"
    },
    "folder": {
      "description": "Optional folder filter, e.g. Engineering.",
      "type": "string"
    }
  }
}

Use this BEFORE answering anything about the user's own context — their projects, conventions, decisions, people, infrastructure, past work. Searches the user's Brain files (their brains plus those shared with them); every word of the query is matched on its own, case-insensitively, and files are ranked by how many words hit. Returns the matching files with the surrounding lines so you can decide what to brain_get. Needs a signed-in user.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Keywords to look for; each word is matched on its own, case-insensitively.",
      "type": "string"
    },
    "brain": {
      "description": "Optional brain to search (owner-handle/name for shared brains). Omit to search all.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

Read one Brain file by name (e.g. coding-conventions.md), across your brains and brains shared with you. Needs your agent bearer token.

{
  "type": "object",
  "properties": {
    "name": {
      "description": "File name including .md",
      "type": "string"
    },
    "brain": {
      "description": "Optional brain to read from (owner-handle/name for shared brains). Omit to search all your brains.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ]
}

Create or update a Brain file. Writes to your default brain unless you name one; shared brains need editor access. Replaces the whole body (use mode "append" to add to the end); the previous body is kept as a version. Credentials are refused — the Brain is memory, not a vault. Needs your agent bearer token.

{
  "type": "object",
  "properties": {
    "name": {
      "description": "File name ending in .md, e.g. customer-faq.md",
      "type": "string"
    },
    "body": {
      "description": "Markdown content.",
      "type": "string"
    },
    "mode": {
      "description": "replace (default) or append.",
      "type": "string"
    },
    "folder": {
      "description": "Folder, e.g. Company. New files default to \"Agent\".",
      "type": "string"
    },
    "brain": {
      "description": "Brain to write into (owner-handle/name for shared brains, needs editor access). Omit for your default brain.",
      "type": "string"
    }
  },
  "required": [
    "name",
    "body"
  ]
}