Skills

A Skill is a portable package containing a SKILL.md, optional maestro.yaml policy and optional deterministic cases under evals/cases.yaml. A Skill is not a provider and not a shell plugin: it is bounded instruction/context selected for a governed execution.

Runtime behavior

Discovery loads metadata first. Instructions enter a provider prompt only after selection and within the configured budget. Each Goal pins the selected version hash, trigger reason and invocation mode. Private skill instructions are not persisted in Dashboard evidence.

Safety

Skills are disabled by default. Enable the runtime explicitly:

MAESTRO_SKILLS_ENABLED=true
MAESTRO_SKILLS_PATH=skills
MAESTRO_SKILL_VERSIONS_PATH=.maestro/skill-versions
MAESTRO_SKILLS_PROJECT_KEY=maestro

The initial packages include read-only diagnosis/review skills and an explicitly selected safe implementation skill. A version fails closed when its trigger, guardrail, syntax or policy check regresses.