Markdown behaviors for hako-code and hake. Drop a folder, name it, the agent loads it.

_{site catalog  ·  SKILL.md spec  ·  hako-code  ·  hako-edit  ·  org}

_{—— I ——}

Catalog

Pull only what you want — each is a self-contained folder, pure markdown, works in any agent or LLM.

— 01 —	corp A company in a folder. CEO · DEV · DESIGN · QA · ARCH — routes tasks by domain. Ships as CLAUDE.md + AGENTS.md, molds to its host.
— 02 —	brief Token-lean output. Cut ~50–75% of length, keep every fact. Drops filler, not information.
— 03 —	memory Durable cross-session memory: a MEMORY.md index + one-fact-per-file, with recall & dedupe rules. No database.
— 04 —	sync Change once, update everywhere — docs, version strings, sibling repos, JSON. Kills the "did I get them all?" miss.
— 05 —	scope Vague ask → goal + explicit non-goals + smallest viable step, before building. Stops scope creep.
— 06 —	release Bump version consistently, write the changelog, generate a multi-repo push-order checklist.
— 07 —	handoff Write a START-HERE state doc (done / next / gotchas) so the next session resumes in seconds.
— ·· —	your skill here Open a PR. Folder name becomes the invocation.

_{—— II ——}

Install

Both hako (the agent) and hake (the editor's Rei pane) read skills from ~/.hako/skills/.

git clone https://github.com/mithraeums/skills /tmp/skills_tmp
cp -r /tmp/skills_tmp/<skill> ~/.hako/skills/
rm -rf /tmp/skills_tmp
hako                  # "loaded 1 skill(s)"

Or from inside a session: :skill install <url>. The agent loads any folder containing a SKILL.md at startup; inner files are pulled on demand via the read_skill(skill, path) tool.

_{—— III ——}

Format

Every skill is a folder:

<skill-name>/
├── SKILL.md          dispatcher: frontmatter + intro + agent map
└── (any *.md, agents/, helpers, assets)

SKILL.md frontmatter:

---
name: <skill-name>
description: >
  One-paragraph summary. When to load. What it solves.
  Include trigger phrases.
---

Inside SKILL.md: keep it dispatcher-shaped — orient the model, list which inner files exist, hand off. Under 50 lines is the goal. If a skill needs more, split it into agents.

_{—— IV ——}

Compatibility

Tool	Path	Status
hako-code (hako)	~/.hako/skills/	native, read_skill tool
hake (Rei pane)	~/.hako/skills/	native, system-prompt inject
Claude Code	.claude/skills/	drop-in
Codex CLI · Cursor · Gemini CLI · OpenCode · Windsurf	varies	markdown is markdown

_{—— V ——}

Contribute

git clone https://github.com/mithraeums/skills
git checkout -b add/your-skill
# add your-skill/SKILL.md (+ any agents/helpers)
git push origin add/your-skill
# open PR

Keep skills referential, not prescriptive. Token budget first. The dispatcher orients — the model reasons.

_{— deus sol invictus mithras —}