torusv0.24.0docs

Agent Skills portability: skills/

torus’s skills (skills/*/SKILL.md) follow the Agent Skills open standard. Compliance is machine-enforced by tests/skills-spec.test.mjs: one directory per skill containing exactly one SKILL.md, ----delimited frontmatter plus a non-empty markdown body, a name matching the directory (^[a-z0-9]+(-[a-z0-9]+)*$, 1-64 chars, with no leading, trailing, or doubled hyphens), a required description (≤1024 chars), and only the spec’s optional fields beyond those two.

Skill layout

PieceRequiredNotes
SKILL.mdyesFrontmatter (name, description) + instructions
Supporting filesnoscripts/, references/, assets/: whatever the skill ships (torus-research carries assets/ and bin/)

This is the spec’s layout, so a skill moves between agents as a plain directory copy: no adapter, no conversion.

Export to Claude Code or Codex

Copy any skills/<name>/ directory to the target agent’s skills location:

AgentLocation
Claude Code~/.claude/skills/<name>/
Codex~/.agents/skills/<name>/

The skill works unchanged: SKILL.md plus optional scripts, references, and assets are spec layout. See Claude Code’s skills documentation.

Import external skills into torus

Drop any Agent-Skills-standard skill into:

  • ~/.agents/skills/: user-global, available in every session
  • .agents/skills/: project-local

pi (the engine torus runs on) discovers these natively: project .agents/skills/ directories are scanned from the working directory through its ancestors, stopping at the repository root when one exists, and only for projects the engine’s trust manager has marked trusted. No torus code is involved; a discovered skill’s name, description, and path enter the system prompt at startup like a bundled skill.

Name collisions

AgentSame-name resolution
Claude CodeTiered precedence: enterprise > personal > project
pi / torusNo tiers: the first discovered skill wins (a warning notes the collision)

Keep skill names unique when sharing between agents; nothing re-ranks them for you.

Delegation

Skills forward to delegated children via the delegation skills parameter (see the roster section).