From 53e3814ba845baa57173084035ec61e57a5162c5 Mon Sep 17 00:00:00 2001 From: Bryan Ramos Date: Thu, 2 Apr 2026 07:09:40 -0400 Subject: [PATCH] feat(skills): add when_to_use frontmatter for skill discovery guidance --- skills/conventions/SKILL.md | 1 + skills/orchestrate/SKILL.md | 1 + 2 files changed, 2 insertions(+) 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.