todos

Aggregates Todoist-style tasks from vault files into deadline-aware sorted lists.

1|1|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/christianvedels/claude-pa --skill todos-christianvedels
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todos
Source: https://github.com/christianvedels/claude-pa/tree/main/.claude/skills/todos
Command: npx skills add https://github.com/christianvedels/claude-pa --skill todos-christianvedels

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of scattered, inconsistent todo tracking by aggregating your tasks across all vault todo files into a single, deadline-aware view.

Core Features & Use Cases

  • Loads and applies reliability + behavioral rules: Reads _system/todo-rules.md and _system/commandments.md, and loads the user profile to locate Python for due-date checking.
  • Runs due-date checking when possible: Executes _system/check_due.py (or falls back to skipping due-date checking if Python isn’t discoverable).
  • Aggregates tasks across todo sources: Reads every Markdown file in todos/ except todos/README.md, omits completed tasks, sorts tasks into deadline buckets, and flags tasks open for 2+ weeks.
  • Supports safe, instruction-only updates: Waits for user instructions and only then allows adding tasks, marking tasks done (with explicit confirmation), or updating deadlines/notes.

Quick Start

Run the todos skill command to get an aggregated, sorted list of your open tasks with overdue and upcoming deadlines highlighted.

Frequently Asked Questions about todos

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

FAQPage Schema
How do I aggregate tasks from multiple markdown files into a single deadline-aware list?

Aggregating tasks from multiple markdown files into a deadline-aware list involves reading every file in your todos folder, omitting completed tasks, and sorting open items into overdue, today, next 7 days, next 30 days, and no-deadline categories.

Can I track overdue todo items across my entire markdown vault?

Tracking overdue todo items across a markdown vault is possible by running a Python due-date checker against your aggregated tasks, which flags overdue items and highlights tasks open for two or more weeks.

Do I need Python installed to check deadlines for tasks in my markdown vault?

Checking deadlines requires Python to execute the due-date checking script, but the task aggregation process automatically falls back to skipping deadline checks if Python is not discoverable in your user profile.

What is the best way to manage scattered personal tasks across multiple markdown files?

Managing scattered personal tasks is best handled by loading behavioral rules, aggregating open tasks from your todos folder, and sorting them into consistent deadline buckets for unified planning and follow-up.

How do I safely update task deadlines and mark items as done without accidental changes?

Safely updating task deadlines and marking items done requires waiting for explicit user instructions, after which the system only allows task changes with explicit confirmation to prevent accidental modifications.