working-off-of-todo-files

Read, update, and validate tasks in ai-notes todo files.

14|8|Updated Aug 9, 2011
One-click install
npx skills add https://github.com/kurko/dotfiles --skill working-off-of-todo-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: working-off-of-todo-files
Source: https://github.com/kurko/dotfiles/tree/main/ai/skills/working-off-of-todo-files
Command: npx skills add https://github.com/kurko/dotfiles --skill working-off-of-todo-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing and systematically working through todo.md or todo.txt files can be challenging, especially for complex projects with many subtasks. This Skill empowers the AI to autonomously read, prioritize, execute, and update tasks in your todo files, ensuring consistent progress and freeing you from manual task management.

Core Features & Use Cases

  • Single Task Focus: The AI works on one task at a time, breaking it down mentally into subtasks and providing clear progress updates.
  • Automated Status Updates: Automatically marks tasks as in-progress ([/]) and completed ([x]), keeping your todo file always up-to-date.
  • User-Controlled Workflow: The AI waits for your explicit instruction before moving to the next task, maintaining your oversight.
  • Use Case: You have a todo.md file outlining a new feature. Simply activate this Skill, and the AI will systematically tackle each item, from setting up the database to implementing API endpoints, updating the file as it goes, and asking for your approval to proceed.

Quick Start

Look at the 'ai-notes/project-x/todo.md' file and start working on the first pending task.

Frequently Asked Questions about working-off-of-todo-files

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

FAQPage Schema
How do I automate task execution from todo files?

Automating task execution from todo files means having an AI systematically read, prioritize, and complete tasks while updating progress markers like `[/]` for in-progress and `[x]` for completed. This Skill processes `todo.md` or `todo.txt` files in your `ai-notes` directory, breaking down complex work into manageable subtasks and maintaining a single-task focus until each is done.

Can I use todo files for project task management and automation?

Yes. Todo files work well for project task management when structured with clear progress markers and subtasks. This Skill enforces single-task focus, explicit progress tracking, and controlled task advancement with your confirmation, making it suited for codebases where tasks must be completed sequentially and status needs updating automatically.

How do I set up and start working through a todo file?

Point the Skill to your `todo.md` or `todo.txt` file in the `ai-notes` directory structure, and it begins reading pending tasks from the top. The AI works through one task at a time, marks progress, and requests your explicit approval before moving to the next item, keeping you in control of workflow advancement.

What happens when tasks have subtasks or dependencies?

The Skill decomposes multi-step tasks into subtasks, processes them sequentially while maintaining mental context, and updates each subtask's status independently. Explicit progress markers and clear decision communication help track which subtasks are blocked, in-progress, or complete.

Does this work with markdown and plain text todo formats?

Yes. This Skill processes both `.md` and `.txt` todo files stored in the `ai-notes/**/*/todo.*` path pattern. It reads and validates tasks in either format, applies consistent progress markers, and safely updates files while enforcing structured status tracking across both file types.

What safeguards are in place when updating todo files?

Safe file operations include controlled task advancement (requiring user confirmation before proceeding), clear communication of blockers and completion status, and explicit progress markers to prevent unintended state changes. The AI waits for your instruction before modifying tasks or advancing to new work.