file-todos

Create and manage markdown todo files with status lifecycles in the todos/ directory.

47|7|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/salavender/antigravity-compound-engineering-plugin --skill file-todos-salavender
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/salavender/antigravity-compound-engineering-plugin/tree/main/skills/file-todos
Command: npx skills add https://github.com/salavender/antigravity-compound-engineering-plugin --skill file-todos-salavender

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the creation, triage, and tracking of work items stored as markdown files in the todos/ directory, reducing miscommunication and manual follow-ups.

Core Features & Use Cases

  • Todo creation and consistent naming in the todos/ directory using a {id}-pending-{priority}-{description}.md convention.
  • Status lifecycle management (pending -> ready -> complete) with lightweight dependency checks.
  • Quick workflows for triage, work-on, and dependency management across projects.

Quick Start

Create a first todo by adding a new markdown file under todos/ following the {id}-pending-{priority}-{description}.md naming convention.

Frequently Asked Questions about file-todos

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

FAQPage Schema
How do I track file-based todos with markdown frontmatter?

You can track file-based todos with markdown frontmatter by organizing work items as markdown files under the todos/ directory. This eliminates scattered tracking by providing lightweight, auditable task management across projects.

What is the best way to organize lightweight task management in a local repository?

The best way to organize lightweight task management in a local repository is using markdown-based todos with YAML frontmatter. This provides auditable status lifecycles and simple dependency management without external databases or complex tracking tools.

How do I manage status transitions for markdown todos?

Manage status transitions for markdown todos by applying a lifecycle from pending to ready to complete. This workflow includes lightweight dependency checks to ensure tasks are ready for execution and properly audited across projects.

Does this file-based todo system support task dependencies?

Yes, this file-based todo system supports simple dependency management within a local repository. It applies lightweight dependency checks during the status lifecycle transitions to ensure work items are ready before execution.

Can I use markdown todo files for team workflow automation?

Yes, you can use markdown todo files for team workflow automation. The system applies to individual contributors and teams needing auditable task management, automating creation, triage, and tracking to reduce manual follow-ups.

When should I not use a local markdown todo directory for task tracking?

You should not use a local markdown todo directory for task tracking if your projects require complex cross-repository dependencies or centralized database-driven management. It is designed for lightweight, local repository task tracking rather than heavy enterprise workflows.