Execute repo work one task at a time using a strict plan → execute → iterate loop tracked in .copilot-todo.yaml.
npxskills add majiayu000/claude-skill-registry--skill task-orchestrationLoading…
Use this skill to drive work through a single authoritative YAML todo file: .copilot-todo.yaml.
.copilot-todo.yaml — only status tracker..copilot-todo.md — legacy/migration only (do not update by hand).# Copy the template to your repo root or session folder
cp .github/skills/task-orchestration/template/plan.md.template plan.md
# Edit plan.md with your tasks (use Markdown checkboxes: - [ ] Task name)
# Generate .copilot-todo.yaml from your plan
python3 .github/skills/task-orchestration/scripts/task_orchestrator.py \
--plan-md plan.md \
--plan-mode regen \
init
# Copy the template
cp .github/skills/task-orchestration/template/copilot-todo.yaml.template .copilot-todo.yaml
# Edit the tasks section, then initialize
python3 .github/skills/task-orchestration/scripts/task_orchestrator.py init
Template locations:
template/plan.md.template — Markdown plan with task checkboxestemplate/copilot-todo.yaml.template — YAML structure with example taskRepeat until no runnable tasks remain:
.copilot-todo.yaml (default):python3 .github/skills/task-orchestration/scripts/task_orchestrator.py init
plan.md using Markdown task list items (- [ ] ... / - [x] ...).
A1. ... or T-001: ..., that ID is used.P-XXXXXXXX ID is generated from the text.python3 .github/skills/task-orchestration/scripts/task_orchestrator.py \
--plan-md plan.md \
--plan-mode regen \
init
python3 .github/skills/task-orchestration/scripts/task_orchestrator.py next
Plan (short bullets, only for the chosen task)
Execute (minimal diff; run smallest relevant existing build/test)
Update status
python3 .github/skills/task-orchestration/scripts/task_orchestrator.py update <ID> completed --note "..."
# or
python3 .github/skills/task-orchestration/scripts/task_orchestrator.py update <ID> blocked --note "..."
5b) Commit (required when using ralph_loop.py --require-commit)
git add -A
git commit -m "<ID>: <short summary>"
python3 .github/skills/task-orchestration/scripts/task_orchestrator.py add "Title" --deps <ID1,ID2> --priority Medium --goal "..."
To run one fresh Copilot run per task (uses copilot -p, consuming Copilot requests accordingly):
python3 .github/skills/task-orchestration/scripts/ralph_loop.py \
--non-interactive \
--max-steps 10
# or: derive tasks from plan.md
python3 .github/skills/task-orchestration/scripts/ralph_loop.py \
--non-interactive \
--plan-md plan.md \
--plan-mode regen \
--max-steps 10
Notes:
ralph_loop.py enforces one commit per finished task (use --no-require-commit to disable).--max-steps small to avoid burning requests if a task gets stuck.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).