file-todos

Manage todos in markdown files with YAML frontmatter.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/praburajasekaran/ruthva-clinic-os --skill file-todos-praburajasekaran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/praburajasekaran/ruthva-clinic-os/tree/main/.gemini/skills/file-todos
Command: npx skills add https://github.com/praburajasekaran/ruthva-clinic-os --skill file-todos-praburajasekaran

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill simplifies the process of managing and tracking todos using a file-based system, making it easy to create, update, and prioritize tasks.

Core Features & Use Cases

  • File-Based Todo Tracking: Create, update, and manage todos in markdown files within a todos/ directory.
  • Lifecycle Management: Manage the lifecycle of todos from pending to ready to complete.
  • Dependency Tracking: Set and check dependencies for todos to ensure they are completed in the correct order.
  • Integration: Integrate with development workflows such as code review and PR comments.
  • Use Case: Organize and prioritize tasks related to code review feedback, technical debt, feature requests, and work items.

Quick Start

Create a new todo with the command 'file-todos create todo "description" priority p1'.

Frequently Asked Questions about file-todos

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

FAQPage Schema
How do I manage markdown todos with dependency tracking in a file-based system?

Markdown todos are managed by creating files within a `todos/` directory using YAML frontmatter to track status and dependencies. This file-based system supports todo creation, status updates, and dependency checks to ensure correct execution order.

What's the best way to track task dependencies using markdown files for development workflows?

Tracking task dependencies using markdown files involves utilizing YAML frontmatter to define prerequisite relationships. The system checks these dependencies to manage the todo lifecycle from pending to ready to complete, integrating seamlessly into development workflows.

Can I use shell scripting to automate todo lifecycle management in markdown?

Yes, shell scripting is utilized to automate markdown processing for todo lifecycle management. Scripts handle todo creation, status updates, and dependency tracking within the file-based system, enabling integration with code review and PR comment workflows.

How do I create and prioritize tasks in a file-based todo system?

Tasks are created and prioritized in the file-based todo system using the command `file-todos create todo "description" priority p1`. This generates a markdown file with YAML frontmatter to track the todo's priority and status.

Does file-based task management work for organizing technical debt and code review feedback?

File-based task management works for organizing technical debt and code review feedback by storing these items as markdown todos. Users can update statuses, set dependencies, and prioritize tasks within the dedicated `todos/` directory.

What are the limitations of using a markdown todo system for complex project management?

A markdown todo system is limited to text-based tracking within a `todos/` directory and lacks native visual dashboards. It is designed for development workflows like code review and technical debt tracking rather than enterprise-scale project management.