Skip to content

Per-Harness Skill Layout Guidance

Choose a tag to compare

@Foxfire1st Foxfire1st released this 30 May 20:57

Agents Remember 0.9.3

Docs-fix release. The install guidance could lead a model to install skills in the wrong layout for Claude Code, so the harness never discovered them.

Highlights

  • docs/install/claude-code.md: removed the false claim that Claude Code "discovers nested .claude/skills directories" and that the default tree layout suffices. Claude Code is a direct skill-folder scanner needing <skill-root>/<name>/SKILL.md one level deep — the docs now prescribe skills_install(layout="flat") with the concrete resulting paths, and note tree is for recursive scanners (Codex).
  • mcp/README.md: added a "Per-harness setup pages" link table (mirroring getting-started) plus a one-line rule that skill layout is harness-specific (flat for Claude Code/Cursor, tree default for Codex), with layout reminders in the install-order steps.