無料GitHub で公開

ledger-tasks-yylo

Durable in-repo task state for coding agents — Kanban tasks with stable IDs, evidence-backed status marks, blocked-by dependencies, and next-ready selection. Use when starting, selecting, sequencing, or closing implementation tasks for a coding-agent project.

mxyhi/ok-skills

インストール方法を見る

含まれるファイル（2）

SKILL.md3.2 KB
LICENSE1.0 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

YYLO Ledger Task Management

Use this skill when a coding agent needs durable, reviewable task state that lives in the repository instead of a chat transcript. YYLO Ledger is the source of truth for task state; this skill teaches the working loop.

Adapted from the canonical ledger-tasks-yylo skill in yylo-dev/yylo-skills; see the upstream SKILL.md for the full CLI reference (archives, multi-directory merges, controller routing).

When to Use

Decide which task is safe to start next (ready = all blockers done)
Start assigned work and record an evidence receipt (mark in_progress --response)
Close a task with what changed and how it was tested (mark done --response --commit)
Declare dependencies between tasks before creating them
Sequence parallel work topologically (order --scores)

Workflow

Pick work: yy ledger ready (or yy ledger list --status todo,in_progress).
Inspect full state before any mutation: yy ledger get TASK_ID (includes resolved blocked_by and related tasks).
Start: yy ledger mark in_progress --id TASK_ID --response "Starting: <plan>".
Finish: yy ledger mark done --id TASK_ID --response "Done: <what> — tested <how>" --commit <sha>.
If the task cannot proceed, keep the blocker explicit instead of closing it silently.

Core Commands

yy ledger create "Short, one-iteration task" --status backlog --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 update TASK_ID --tags backend,urgent
yy ledger deps add --id TASK_ID --blocked-by BLOCKER1 BLOCKER2
yy ledger ready --tag backend
yy ledger order --scores
yy ledger archive TASK_ID        # soft delete, preserves data

Inline body markup is parsed on create/update, so dependencies can be declared in prose:

[blocked_by]TASK_ID[/blocked_by]     — this task waits on TASK_ID
[task_id]RELATED_ID[/task_id]        — cross-reference a related task

Best Practices

Keep tasks small enough to finish in one iteration without filling the context window.
Status flow: backlog -> todo -> in_progress -> done (archive for abandoned tasks).
Always pass --response on mark; attach --commit when marking done so task history links to the diff.
Use ready before starting, and order --scores when planning parallel pipelines.
Read state with get before mutating; never bypass the CLI with direct file edits.

Prerequisites

YYLO CLI: npm install --global '@yylo/cli@latest' (Node.js 20.10+, npm, Git). yy ledger delegates to the standalone YYLO Ledger Git-native task store (MIT).
Task state lives under the repository's .juno_task/ directory and is committed with the project, so any agent or reviewer can reconstruct decisions from history.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

agent-browser

無料

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

日本語の概要は準備中です。原文の説明を表示しています。