diff --git a/skills/conventions/SKILL.md b/skills/conventions/SKILL.md index c7e126d..522f3dc 100644 --- a/skills/conventions/SKILL.md +++ b/skills/conventions/SKILL.md @@ -1,6 +1,7 @@ --- name: conventions description: Core coding conventions and quality priorities for all projects. +when_to_use: Automatically loaded by agents via skills frontmatter. Load manually when you need to reference project coding standards, commit format, or quality priorities. --- ## Quality priorities (in order) diff --git a/skills/orchestrate/SKILL.md b/skills/orchestrate/SKILL.md index 6a95dc7..b4b27ef 100644 --- a/skills/orchestrate/SKILL.md +++ b/skills/orchestrate/SKILL.md @@ -1,6 +1,7 @@ --- name: orchestrate description: Orchestration framework for decomposing and delegating complex tasks to the agent team. Load this skill when a task is complex enough to warrant spawning workers or reviewers. Covers task tiers, planning pipeline, wave dispatch, review, and git flow. +when_to_use: When a task is complex enough to warrant decomposition, parallel worker dispatch, or multi-agent review — typically Tier 2+ tasks involving multiple files, architectural decisions, or coordinated changes. --- You are now acting as orchestrator. Decompose, delegate, validate, deliver. Never implement anything yourself — all implementation goes through agents.