anbeime/skill / skills/ledger-tasks-yylo
ledger-tasks-yylo
VerifiedDrive multi-step coding-agent work through a git-native Kanban/task ledger. Use when an agent needs persistent task state across sessions, dependency-aware ordering, status transitions with receipts, or serialized multi-worktree delivery. For task/board operations, not memory or general notes.
YYLO Ledger Tasks
Use this skill when a coding agent needs persistent, reviewable task state that lives in the repository and drives multi-step feature work across sessions.
When to Use
- Planning or executing a multi-step feature that spans several sessions or agents
- Tracking a task board (backlog → todo → in_progress → done) as files inside the repo
- Ordering work by dependencies before starting parallel agents
- Recording status changes with an explicit response receipt and commit link
- Coordinating feature worktrees with serialized merge delivery
Required Workflow
- Read state before mutating:
yy ledger list,yy ledger get TASK_ID,yy ledger ready. - Create small, one-iteration tasks:
yy ledger create "Implement X" --status todo --tags backend. - Record every transition with a receipt:
yy ledger mark in_progress --id TASK_ID --response "Starting: scope Y". - Model blockers explicitly:
yy ledger deps add --id TASK_ID --blocked-by BLOCKER1 BLOCKER2. - Plan parallel work topologically:
yy ledger order --scores. - Link outcomes to git: mark done with
--responseplus--commit HASH. - Never edit
.juno_task/files directly; the CLI is the only sanctioned mutation path and fails closed on controller errors.
Core Commands
yy ledger create "Task description" --status todo --tags feature,backend
yy ledger list --status todo,in_progress --limit 10
yy ledger search --tag backend --open
yy ledger get TASK_ID
yy ledger mark in_progress --id TASK_ID --response "Starting work"
yy ledger mark done --id TASK_ID --response "Done: implemented X, tested Y" --commit abc123
yy ledger update TASK_ID --tags backend,urgent
yy ledger deps TASK_ID
yy ledger ready
yy ledger order --scores
Answer Shape
When answering task questions, include:
- the task's current status and unresolved blockers
- the receipt (
--response) that produced the last transition - the next unblocked task from
ready/orderwhen asked what to work on next
Fallback Rules
- If the
yyCLI is missing, install it first:npm install -g @yylo/cli(Node >= 20). - On controller/routing errors, stop and report; never bypass by editing task files.
- Task state is hot by default; archived tasks surface only via
getand boundedarchive-search. - Cross-project routing is opt-in via registry config; without it, operate from the project root only.
Source
Canonical home: https://github.com/yylo-dev/yylo-skills (MIT). Requires the external YYLO CLI: https://github.com/yylo-dev/yylo
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |