Menu
Author root AGENTS.md as a Where/What/When orchestrator that routes tasks and skill invocation clearly.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | agents-root-orchestrator |
| description | Author root AGENTS.md as a Where/What/When orchestrator that routes tasks and skill invocation clearly. |
| skillMetadata | {"author":"skilly-hand","last-edit":"2026-04-03","license":"Apache-2.0","version":"1.0.0","changelog":"Added root AGENTS orchestration guidance around Where/What/When structure; improves AI task routing clarity and trigger recognition; affects root AGENTS authoring workflow","auto-invoke":"Creating or updating root AGENTS.md orchestration guidance","allowed-tools":["Read","Edit","Write","Glob","Grep","Bash","Task","SubAgent"]} |
Use this skill when:
AGENTS.md for a repository.Do not use this skill for:
CLAUDE.md, GEMINI.md) as primary source.Define where the guide applies and where to escalate:
Define what AI should use:
Define when skills must be invoked:
Define integrated multi-skill chains using explicit notation:
-> to document prerequisite order.Is this the repository-wide instruction entry point?
YES -> Create/update root AGENTS.md with Where/What/When
NO -> Use subfolder AGENTS conventions and inherit parent rules
Does the task require routing across multiple skill types?
YES -> Add Task -> Skill chain table in What
NO -> Keep concise capability list and direct triggers
Are trigger conditions currently implicit or ambiguous?
YES -> Add explicit action-based trigger rows in When
NO -> Keep existing triggers but normalize wording
## Where
- Scope: repository root and all descendant folders unless overridden.
- Primary map: app code in `src/`, automation in `scripts/`, tests in `tests/`.
- Escalate to maintainers when task changes CI, security, or release flows.
## When
| Action | Skill |
| ------ | ----- |
| Planning multi-step feature work | `spec-driven-development` |
| Creating new reusable skill instructions | `forge-me-a-skill` |
| Updating root AGENTS orchestration map | `agents-root-orchestrator` |
## Chaining Notations
Chaining notations document integrated workflows where multiple skills are sequentially invoked for complex tasks. Always invoke skills in documented order.
### Skill Creation Workflow
```text
Asking for a new skill
-> forge-me-a-skill
-> spec-driven-development
-> agents-root-orchestrator
```
When to use: creating and registering a new reusable skill workflow.
mkdir -p .skilly-hand/catalog/agents-root-orchestrator/assets
cp .skilly-hand/catalog/agents-root-orchestrator/assets/AGENTS-ROOT-TEMPLATE.md AGENTS.md
npx skilly-hand install --dry-run
Review code, decisions, and artifacts through an independent committee and safety guard, then optionally run bounded, approval-gated remediation. Trigger: reviewing risky artifacts or remediating structured review findings.
Plan, execute, and verify multi-step work through versioned specs with small, testable tasks. Trigger: planning or executing feature work, bug fixes, and multi-phase implementation.
Guide implementation through evidence-based RED, GREEN, and REFACTOR cycles without assuming a language, framework, or test runner. Trigger: implementing testable behavior or reproducing a regression with tests first.
Guide users from Figma MCP installation and authentication through first canvas creation, with function-level tool coverage and operational recovery patterns.
Capture compact, neutral, AI-ready Markdown handoffs that preserve session context across chats without becoming a full transcript or personal memory store. Trigger: summarizing, compacting, preserving, or handing off session context across chats.
Create and standardize AI skills with reusable structure, metadata rules, and templates.