Skip to content

feat: add ledger-tasks-yylo skill - #55

Closed
InsightFactoryAPP wants to merge 2 commits into
Varnan-Tech:mainfrom
InsightFactoryAPP:add-ledger-tasks-yylo
Closed

InsightFactoryAPP wants to merge 2 commits into
Varnan-Tech:mainfrom
InsightFactoryAPP:add-ledger-tasks-yylo

Conversation

@InsightFactoryAPP

@InsightFactoryAPP InsightFactoryAPP commented Sep 18, 2026 •

Copy link
Copy Markdown

Summary

Adds the ledger-tasks-yylo skill. It gives a coding agent a durable Kanban board the agent operates itself through the yy CLI — tasks, dependencies, readiness, and receipts that survive across sessions.

Solo founders shipping with Claude, Codex, or Gemini agents lose task state the moment a session ends. This skill makes the agent plan, track, and close its own work: implementation-sized tasks, mark done with a response and commit hash, dependency graphs with cycle detection, ready/order for safe parallel execution, and receipt-preserving closes. One prerequisite (@yylo/cli), no API keys, works on any Git repository.

What this skill does

You ask your agent to manage its own work ("create a task for the OAuth refactor", "what's ready to work on?", "mark TASK-42 done - implemented and tested") and it drives the YYLO Ledger board:

  • Create / list / search / get / update / archive tasks with tags, status flow, and related-task markup
  • Mark status transitions with a required response and optional commit link — every done-task carries its evidence
  • Dependencies: deps add/remove, cycle detection, [blocked_by] inline markup
  • Ready & order: unblocked-task filter and topological sort with priority scores
  • Merge: deterministic multi-directory consolidation with plan/receipt files
  • Immutable cold-archive packs for long-term storage, with fail-closed rules

Files

  • skills/ledger-tasks-yylo/SKILL.md — frontmatter + the full agent contract
  • skills/ledger-tasks-yylo/README.md — pitch, prerequisites, usage (install block added by scripts/update_skill_readmes.py)
  • skills/ledger-tasks-yylo/package.json — category Developer Tools
  • README.md, packages/cli/registry.json — regenerated with the repo's own scripts (pnpm exec tsx scripts/update-readme.ts + scripts/build-registry.ts), counts 64 → 65

Validation

  • pnpm exec tsx scripts/validate-pr.ts — all 65 skills valid, descriptions populated
  • scripts/build-registry.ts regenerated; registry is in sync with skills/ (CI check will confirm)
  • scripts/update_skill_readmes.py ran; only pre-existing template drift in another skill's README was reverted to keep this PR additive-only
  • The skill body is the canonical agent contract from yylo-dev/yylo-skills (MIT), adapted to the house SKILL.md frontmatter shape

Disclosure

I'm a contributor on the YYLO project (yylo-dev), submitting our own MIT-licensed skill. This PR was prepared with AI assistance and follows the CONTRIBUTING guide: skill folder + package.json + regenerated registry/README via the repo's own scripts. YYLO's CLI is already listed in 70+ community awesome lists (see the yylo-dev/yylo README badges), and yylo-skills is installable via npx skills add yylo-dev/yylo-skills — so the skills.sh install path works today.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

RetriggerConfidence Score: 5/5

Safe to merge.

Findings

  1. P2 Regenerate plugin skill counts ▶

Summary

Adds the ledger-tasks-yylo skill and synchronizes its catalog and distribution metadata.

  • Defines agent-facing task, dependency, archive, merge, and receipt workflows.
  • Adds installation and usage documentation plus package metadata.
  • Regenerates the CLI registry, root skill catalog, and Claude plugin manifests for 65 skills.

Reviews (2) · Last reviewed commit: "fix: address review - ledger namespace c..."

Comment thread skills/ledger-tasks-yylo/SKILL.md Resolved
Comment thread README.md

<div align="center">
<img src="https://readme-typing-svg.demolab.com?font=Fira+Code&size=20&duration=3000&pause=800&color=58A6FF&center=true&vCenter=true&width=620&height=50&lines=64+Agent+Skills;Works+with+Claude%2C+Codex%2C+Gemini+CLI%2C+Manus+AI;Agent+Skills+for+Founders+Who+Hate+Marketing;Install+in+seconds.+No+setup+required." alt="Typing SVG" />
<img src="https://readme-typing-svg.demolab.com?font=Fira+Code&size=20&duration=3000&pause=800&color=58A6FF&center=true&vCenter=true&width=620&height=50&lines=65+Agent+Skills;Works+with+Claude%2C+Codex%2C+Gemini+CLI%2C+Manus+AI;Agent+Skills+for+Founders+Who+Hate+Marketing;Install+in+seconds.+No+setup+required." alt="Typing SVG" />

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Regenerate plugin skill counts

The root catalog and CLI registry now list 65 skills, but both Claude plugin discovery manifests still advertise 64. Plugin and marketplace users will receive stale catalog metadata; regenerate and commit both manifests so their published count matches the catalog. This is a non-blocking metadata concern.

Knowledge Base Used: Registry generation and release artifacts

Artifacts

Evidence from the check

  • The authored Node script parses all relevant metadata counts and invokes the compiled CLI registry loader, showing whether catalog discovery metadata agrees.

Command output from the check

  • The verifier was executed against a clean archive of `HEAD^`; all catalog and manifest counts are 64, showing the prior state was consistent.

Command output from the check

  • The verifier was executed in the candidate checkout; runtime CLI discovery finds all 65 skills while plugin and marketplace descriptions remain 64, confirming stale discovery metadata.

View artifacts

T-Rex Ran code and verified through T-Rex

@greptile-apps

This comment has been minimized.

@farizanjum

Copy link
Copy Markdown
Contributor

Hi @InsightFactoryAPP,

Thank you for your submission. We are closing this PR for the following reasons:

  1. Repository Scope & Mission: OpenDirectory is focused on GTM, growth automation, and technical marketing skills for founders. Vendor-specific orchestration tooling falls outside our catalog focus.
  2. Self-Contained Requirement: OpenDirectory skills should provide standalone agent capabilities or rely on standard developer tooling. We avoid skills whose primary function is prompting users to globally install external third-party CLIs.
  3. Project Portability: The skill references internal paths and scripts (.juno_task/scripts/controller_resolver.py, \JUNO_WORKSPACE_ROLE) that do not exist in general user repositories, which leads to execution errors for end users.

We appreciate your interest in OpenDirectory!

@farizanjum farizanjum closed this Oct 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants