file-todos

Create, triage, and resolve Markdown todos with YAML frontmatter.

370|33|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/nth5693/gemini-kit --skill file-todos-nth5693
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/nth5693/gemini-kit/tree/main/skills/file-todos
Command: npx skills add https://github.com/nth5693/gemini-kit --skill file-todos-nth5693

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of scattered, manual task tracking by centralizing todo items as Markdown files inside a dedicated todos/ directory, enabling consistent tracking and lifecycle management.

Core Features & Use Cases

  • File-based tracking: Create, triage, and complete tasks stored as Markdown files with YAML frontmatter.
  • Naming conventions and lifecycle: Use the {issue_id}-{status}-{priority}-{description}.md pattern to derive status, blockers, and dependencies, with a simple lifecycle from pending to ready to complete.
  • Use Case: In a software project, convert backlog items into todos and progress them through triage and execution, linking related items via dependencies.

Quick Start

Use this skill to create and manage todos in the todos/ directory. Create a new todo by copying a template to a new file named 001-pending-p1-description.md, then triage and resolve using the provided commands.

Frequently Asked Questions about file-todos

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

FAQPage Schema
How do I automate task triage for markdown-based todo files?โ–ผ

Automate markdown-based todo triage by storing tasks as files in a todos/ directory. The skill uses shell tooling and YAML frontmatter to filter tasks, check dependencies, and update their lifecycle status from pending to complete.

What's the best way to track file-based todos with YAML frontmatter?โ–ผ

Track file-based todos by creating Markdown files with YAML frontmatter inside a dedicated todos/ directory. This centralizes task tracking and enables consistent lifecycle management for your project backlog items.

How do naming conventions work for markdown task management?โ–ผ

Markdown task management naming conventions use the pattern {issue_id}-{status}-{priority}-{description}.md. This structure automatically derives task status, blockers, and dependencies to streamline workflow progression.

Can I link dependencies between file-based todos in a project directory?โ–ผ

Yes, you can link dependencies between file-based todos. The skill performs dependency checks by reading the YAML frontmatter and naming conventions to connect related backlog items during triage and execution.

Does this markdown todo workflow require external dependencies?โ–ผ

No, this markdown todo workflow requires no external dependencies. It relies entirely on YAML frontmatter for metadata, template-based file creation, and shell-based tooling to execute quick commands.

How do I create a new todo from a markdown template?โ–ผ

Create a new todo by copying a template into a new file named using the convention, such as 001-pending-p1-description.md. You then triage and resolve the task using the provided shell commands.