td-task-management

Manage AI agent tasks and state persistence across sessions using the td CLI.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/ramirlm/skillshare-ramir --skill td-task-management-ramirlm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: td-task-management
Source: https://github.com/ramirlm/skillshare-ramir/tree/main/td-task-management
Command: npx skills add https://github.com/ramirlm/skillshare-ramir --skill td-task-management-ramirlm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires td, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill manages AI agent tasks, ensuring progress is tracked, context is maintained across sessions, and work can be handed off reliably.

Core Features & Use Cases

  • Persistent Task Tracking: Logs progress, decisions, and blockers, even when AI context resets.
  • Structured Handoffs: Facilitates clear state transfer between AI agents or sessions.
  • Workflow Management: Supports single-issue focus, multi-issue work sessions, and code review processes.
  • Use Case: An AI agent working on a complex feature can log its progress, decisions made (e.g., choosing a specific library), and any blockers encountered. If the session ends, the next agent can pick up exactly where the last one left off, with full context.

Quick Start

Start a new session and check the current task status by running td usage --new-session.

Frequently Asked Questions about td-task-management

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

FAQPage Schema
How do I maintain AI agent task state across context window resets?

To maintain AI agent task state across context window resets, you need persistent task tracking that logs progress, decisions, and blockers externally. This ensures work resumes exactly where it left off when the session ends or context resets.

What is structured handoff between AI sessions and how does it work?

Structured handoff between AI sessions is the process of transferring task state, logs, and decisions from one agent to another. It works by saving progress externally so the next agent picks up with full context.

How do I start tracking work for a new AI agent session?

To start tracking work for a new AI agent session, initialize the task manager and check the current status. You can start a new session and view the current task status by running the `td usage --new-session` command.

Do I need to install any CLI tools to manage tasks across ephemeral context windows?

Yes, you need the 'td' CLI binary installed and available in your system's PATH to manage tasks across ephemeral context windows. This dependency is required for logging progress and performing structured handoffs.

Can I manage multiple issues in a single AI work session?

Yes, you can manage multiple issues in a single AI work session. The workflow management supports single-issue focus, multi-issue work sessions, and code review processes to handle various development scenarios.

When should I use CLI task management for AI agents instead of manual logging?

You should use CLI task management for AI agents when work spans multiple context windows or requires handoffs. It prevents context loss during complex features by automatically logging decisions and blockers that manual notes often miss.