file-todos

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

3|1|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/i3ringit/antigravity-cortex --skill file-todos-i3ringit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/i3ringit/antigravity-cortex/tree/main/.agent/skills/file-todos
Command: npx skills add https://github.com/i3ringit/antigravity-cortex --skill file-todos-i3ringit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

The File-Based Todo Tracking Skill standardizes tracking and coordination of work items by using Markdown files with YAML frontmatter in the todos/ directory. It replaces ad-hoc notes with a consistent, searchable, and auditable record of feedback, tech debt, and feature work.

Core Features & Use Cases

  • Create new todos using the shared template and filename pattern.
  • Manage todo lifecycle from pending to ready to complete, with dependencies and tags.
  • Triaging pending items, updating work logs, and converting PR comments or findings into tracked items.
  • Quick integration with slash commands and code-review workflows to surface work items.

Quick Start

Use the file-todos skill to create and manage a new todo in the todos/ directory using the provided template and naming conventions.

Frequently Asked Questions about file-todos

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

FAQPage Schema
How do I organize code work with file-based todos instead of scattered notes?

File-based todos use Markdown files with YAML frontmatter stored in a todos/ directory, creating a searchable, consistent record of work items. Each todo enforces required fields like status, priority, issue_id, tags, and dependencies, replacing ad-hoc notes with an auditable workflow.

Can I track dependencies between todos and manage their lifecycle?

Yes. The Skill manages todo lifecycle from pending to ready to complete, with built-in support for dependencies and tags. You can triage pending items, update work logs, and link related todos to coordinate work across code reviews and technical debt.

How do I convert PR comments and code-review findings into tracked work items?

Use slash commands and code-review workflow integration to surface work items directly from pull requests. The Skill accepts feedback and findings, converts them into todos using the standardized template, and stores them in the todos/ directory with proper frontmatter.

What's the fastest way to create a new todo with the correct structure?

The Skill provides a shared template and standardized filename pattern for todos/ directory. Create a new todo by following the template, which automatically enforces required YAML frontmatter fields and ensures consistency across all documents.

Can I use file-based todos to track feature requests and technical debt together?

Yes. File-based todos handle feature requests, technical debt, and code-review feedback in a single system. Tag and prioritize items by type, manage dependencies between work streams, and maintain a unified, searchable record of all work.

Do I need a database or special tool to store and search todos?

No. Todos are stored as Markdown files with YAML frontmatter in the todos/ directory, making them version-controllable, searchable by standard text tools, and auditable without external infrastructure.