skills.rest
benjaminshoemaker
benjaminshoemakerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

run-todos

Automate Git-backed implementation of [ready] TODOs in TODOS.md files.

39|5|Updated Dec 28, 2025
Search Tags:#automation#git#workflow#commit#todo#task-management
One-click install
npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill run-todos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: run-todos
Source: https://github.com/benjaminshoemaker/ai_coding_project_base/tree/main/.claude/skills/run-todos
Command: npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill run-todos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the end-to-end process of implementing items marked as [ready] in TODOS.md within a Git-driven workflow, reducing manual triage and preventing drift between planning and execution.

Core Features & Use Cases

  • Automated ready-item implementation: detects and processes [ready] entries in TODOS.md, converts them into completed work with appropriate commits and documentation.
  • Git-driven workflow enforcement: creates a dedicated implementation branch, stages changes, and records a short commit hash as DONE in TODOS.md.
  • Verification and reporting: runs checks when criteria exist, updates progress in TODOS.md, and generates a concise summary report.
  • Safe operations: guards against untracked secrets being committed and asks for user confirmations when needed.

Quick Start

  1. Ensure TODOS.md exists at the project root and contains items tagged [ready]. 2) From the project directory, run the Run Todos skill to begin implementing selected items. 3) Follow prompts to select items, confirm Git operations, and review the generated summary.

Frequently Asked Questions about run-todos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate implementing ready TODOs with Git commits?▼

Automating Git commits for ready TODOs requires processing [ready]-tagged items in TODOS.md, creating a branch, and recording a commit hash. This skill handles the end-to-end implementation automatically.

What is a Git-driven workflow for managing TODOS.md task implementation?▼

A Git-driven TODOS.md workflow converts [ready] items into completed commits, maintaining traceability by recording the short commit hash as DONE. It prevents drift between planning and execution.

Do I need external task-management tools to automate TODOS.md commits?▼

You do not need external task-management tools to automate TODOS.md commits. This workflow requires no external tooling beyond standard Git operations to implement items and update progress.

How to update TODOS.md status automatically after a Git commit?▼

Updating TODOS.md after a Git commit involves recording the short commit hash as DONE for the implemented item. This skill generates a concise summary report and updates progress automatically.

Does automated TODO implementation guard against committing untracked secrets?▼

Automated TODO implementation guards against committing untracked secrets by enforcing safe operations. It also runs checks when criteria exist and asks for user confirmations when needed.

Can I use run-todos for software projects without a structured feature workflow?▼

Using run-todos targets software projects using a structured feature workflow with a TODOS.md file at the root. You need [ready]-tagged items present for the automated implementation to process.

Related Skills

Explore More Software Engineering Skills→
i3ringiti3ringit
3

file-todos

Manage Markdown todo files with YAML frontmatter in the todos/ directory.

Community
Basic
biwakonbubiwakonbu

git-push

Push the current Git branch to the remote with safety checks.

Community
Intermediate
tgmarinhotgmarinho

setup-pre-commit

Automate pre-commit hook setup with Husky and lint-staged.

Community
Intermediate
valegrajalesvalegrajales

resolve_todo_parallel

Analyze TODO comments in markdown files and resolve them in parallel.

Community
Intermediate