Skills & Usage
hm_skill
Fetch the latest HyperMemory agent skills and your organization's published skills
hm_skill serves agent skills: instruction files (SKILL.md) that teach an agent how to work. It returns the built-in HyperMemory protocol, system skills published by HyperMemory, your own custom skills, and the published skills of every organization you belong to. See Skills Distribution.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
action | "list" | "get" | "check_update" | "get" | List available skills, get one, or check whether a newer version exists. |
variant | string | general | A built-in protocol variant: general, project, cursor or cli. claude, claude-code, openai, chatgpt, gpt, codex, openclaw and hermes are aliases of general. |
name | string | — | A skill by name, e.g. memorize-full-chat, hypermemory-software-development or one of your own. |
skill_id | string | — | A custom or organization skill by id. |
current_version | string | — | With check_update: the version you have installed. |
include_content | boolean | true for get | Include the skill’s content (and its documents) in the answer. |
Response
| Action | Returns |
|---|---|
list | catalog_version, version and skills — every skill you can get, each with its name, version, scope and, for custom skills, skill_id, revision, sha256 and the organization it comes from. |
get | catalog_version and skill, with its content and files. |
check_update | Also current_version, latest_version and update_available. |
Built-in and system skills
| Skill | What it does |
|---|---|
general | The HyperMemory protocol for any agent: recall before replying, store new facts, report tokens. |
project | The protocol for project instruction files. |
cursor | The protocol tuned for Cursor. |
cli | The protocol for agents that use the hm CLI instead of MCP. |
memorize-full-chat | Commit an entire conversation to memory, one node per entity, cross-linked. |
hypermemory-software-development, hypermemory-marketing, hypermemory-legal, memory-quality-audit | Domain skills published by HyperMemory as system skills. Get them by name. |
Skills with supporting documents
A custom skill can ship documents beside its SKILL.md. They are listed in skill.files, each with a path relative to the skill directory, its sha256 and size_bytes, and — from get, or check_update with content — its content.
Install such a skill as a directory: write skill.content verbatim as SKILL.md, and every file’s content verbatim at its path. SKILL.md links to the documents by those paths. The skill’s sha256 covers SKILL.md and all its documents.
Examples
{ "action": "list" }{ "action": "get", "variant": "general" }{ "action": "check_update", "variant": "general", "current_version": "0.12.0" }