Best Practices

Agent Layer keeps three authoring surfaces separate because they solve different problems. Skills define reusable workflows, CLI skills route agents to installed commands, and instructions define the always-loaded contract.

Guides​

Skill Design Guide​

Write focused agent skills that activate reliably, conserve context, and guide multi-step work with measurable success criteria.

CLI Skill Design Guide​

Design skills for installed command-line tools without copying stale manuals or wrapping ordinary CLI workflows in MCP unnecessarily.

Instruction Design Guide​

Write concise, durable agent instructions that avoid duplicated rules and preserve context for the task itself.