file-todos

Create and triage markdown todos with YAML frontmatter in a repository.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Andreicr1/Netz-Private-Credit-OS --skill file-todos-andreicr1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/Andreicr1/Netz-Private-Credit-OS/tree/main/.github/skills/file-todos
Command: npx skills add https://github.com/Andreicr1/Netz-Private-Credit-OS --skill file-todos-andreicr1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

The file-todos skill standardizes and operationalizes repository-level todo management so that code review feedback, technical debt, and ad-hoc work items are captured, triaged, and completed reliably instead of being lost in PR comments or chat.

Core Features & Use Cases

  • Create and standardize todos: Use the provided template and filename conventions to produce consistent markdown todos with YAML frontmatter including status, priority, issue_id, tags, and dependencies.
  • Triage and lifecycle management: Move items from pending to ready to complete, update frontmatter, rename files to reflect status changes, and fill Recommended Action and Acceptance Criteria during triage.
  • Dependency and work-log tracking: Declare blockers via the dependencies field, check for unblocked items before starting work, and maintain chronological Work Log entries for auditability.
  • Integrations: Convert PR comments or review findings into todos, use slash commands for interactive triage, and commit completed items with clear references.

Quick Start

Copy the assets/todo-template.md into the todos/ directory using the next sequential issue id, fill the required sections, set status to pending or ready as appropriate, and commit the new todo.

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 feedback as file-based todos in a repository?▼

Track code review feedback as file-based todos by creating standardized markdown files in a repository todos/ directory. Each file uses YAML frontmatter for status, priority, and dependencies, converting PR comments into auditable work items.

How does dependency management work for markdown-based technical debt tracking?▼

Dependency management for markdown todos works by declaring blockers in the YAML frontmatter dependencies field. Before starting work, the system checks for unblocked items to ensure downstream tasks are ready and prevent stalled technical debt resolution.

Can I use slash commands for triaging pending work items during a PR review?▼

Yes, slash commands support interactive triage of pending work items during PR reviews. They enable moving items from pending to ready or complete, updating frontmatter, and renaming files to reflect status changes automatically.

What is the best way to maintain an audit trail for completed technical debt items?▼

Maintain an audit trail for completed technical debt items by recording chronological Work Log entries within the markdown todo. This explicit logging ensures all actions are auditable and provides clear references when committing completed work.

Do I need YAML frontmatter to manage repository todos and work logs?▼

Yes, YAML frontmatter is required to manage repository todos and work logs. It enforces consistent metadata capture for status, priority, issue_id, tags, and dependencies, ensuring standardized lifecycle management and unblocking of downstream work.

What filename conventions are needed for todo lifecycle management in a codebase?▼

Filename conventions for todo lifecycle management require using sequential issue IDs and renaming files to reflect status transitions. This standardization ensures reliable tracking from pending through ready to complete states across the codebase.