file-todos

Create and manage markdown todo files with YAML frontmatter for code review findings.

12|2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/jikig-ai/soleur --skill file-todos-jikig-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/jikig-ai/soleur/tree/main/plugins/soleur/skills/file-todos
Command: npx skills add https://github.com/jikig-ai/soleur --skill file-todos-jikig-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Provide a simple, auditable file-based workflow to capture code review findings, technical debt, feature requests, and work items as markdown todos so nothing from reviews or investigations is lost or forgotten.

Core Features & Use Cases

  • Create and standardize todos: Use a template and filename convention to record problems, findings, proposed solutions, acceptance criteria, and work logs.
  • Triage and lifecycle management: Move items from pending to ready to complete, adjust priority, and record recommended actions during triage.
  • Dependency and integration handling: Track blockers via YAML frontmatter, discover what a todo blocks or is blocked by, and integrate with PR/code-review workflows.

Quick Start

Create a new todo from a PR finding and save it in the todos/ directory with status pending for triage.

Frequently Asked Questions about file-todos

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

FAQPage Schema
How do I track code review findings as markdown todos?

Track code review findings as markdown todos by creating files in a todos/ directory using enforced filename conventions and YAML frontmatter to capture problems, proposed solutions, and acceptance criteria.

What is the best way to manage technical debt items in a file-based workflow?

Manage technical debt in a file-based workflow by recording items as markdown files with YAML frontmatter, enabling triage from pending to ready to complete, adjusting priority, and logging work for auditable traceability.

Can I track todo dependencies and blockers using YAML frontmatter?

Yes, you can track todo dependencies and blockers using YAML frontmatter fields to record what a todo blocks or is blocked by, ensuring dependency checks prevent completing items with unresolved blockers.

How do I create a standardized todo template for PR comments?

Create a standardized todo template for PR comments by applying filename conventions and YAML frontmatter fields to record the finding, proposed solution, acceptance criteria, and work logs in the todos/ directory.

When should I not use a file-based todo system for technical debt?

Avoid file-based todo systems for technical debt when you need real-time collaborative editing or automated cross-repository synchronization, as this approach relies on static markdown files and manual status transitions.