todos

Manage persistent todo items in markdown files within a repository.

Updated Jun 13, 2026
One-click install
npx skills add https://github.com/taloncjones/dotfiles --skill todos-taloncjones
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todos
Source: https://github.com/taloncjones/dotfiles/tree/main/claude/skills/todos
Command: npx skills add https://github.com/taloncjones/dotfiles --skill todos-taloncjones

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a persistent and session-independent todo tracking system, ideal for managing tasks across multiple work sessions.

Core Features & Use Cases

  • Cross-Session Todos: Create, list, complete, and review todos that persist across sessions.
  • Todo File Management: Organize todos into pending and completed categories with timestamped files.
  • Customization: Customize todo priority, due dates, and tags for better organization.
  • Use Case: When you want to keep track of todos for a project, this Skill allows you to capture and manage tasks from anywhere and at any time, ensuring nothing falls through the cracks.

Quick Start

To start tracking todos, run the command: todos.sh init to initialize the todo system, and then use todos.sh new "Add a todo" to create a new todo.

Frequently Asked Questions about todos

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

FAQPage Schema
How do I track todos across multiple sessions in a repository?

You track cross-session todos by managing persistent markdown files stored directly in your repository. This system organizes items into pending and completed categories, ensuring tasks persist across multiple work sessions.

How do I create a new todo with a due date and priority?

You create a new todo by running the script to initialize a new task, then customize it with priority levels and due dates. This generates a timestamped markdown file to organize and track the task.

Can I manage todo lists using markdown files in my repository?

Yes, you can manage todo lists entirely through markdown files within a specified repository. The system creates timestamped files for each item and handles creating, listing, and completing tasks directly in your project directory.

What is the best way to organize pending and completed task files?

The best way to organize task files is using the built-in categorization, which automatically separates todos into pending and completed directories with timestamped markdown files for accurate cross-session tracking.

Do I need any external dependencies to run the cross-session todo script?

No external dependencies are required to run the cross-session todo script. You only need to execute the initialization command to set up the markdown file tracking system within your current repository environment.