cc-task-state

Persists task progress, interruptions, and recovery points into project-level task state files.

1.0k|109|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/doccker/cc-use-exp --skill cc-task-state
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cc-task-state
Source: https://github.com/doccker/cc-use-exp/tree/main/.codex/skills/cc-task-state
Command: npx skills add https://github.com/doccker/cc-use-exp --skill cc-task-state

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Progress updates shared in conversation often get lost between sessions, making it hard to resume interrupted work or track pending requirements. This Skill converts natural-language progress descriptions into durable task state files stored in the project's .codex/tasks/ directory.

Core Features & Use Cases

  • Task State Persistence: Records tasks with statuses like in-progress, interrupted, blocked, or pending into .codex/tasks/ and archives finished work.
  • Multi-Task Splitting: Splits a single message containing multiple task subjects into separate task records instead of one vague summary.
  • Interruption Checkpoints: Adds checkpoint entries to a main task when short fixes interrupt it, preserving recovery entry points and next steps.
  • Use Case: You tell the assistant "the routing dialog work is still in progress, but the new log-filter feature hasn't started and I got interrupted by a fix" — the Skill writes two separate task files with correct statuses and a checkpoint on the main task.

Quick Start

Use cc-task-state to record my current progress, note the interrupted main task, and save the not-yet-started feature as a pending requirement.

Frequently Asked Questions about cc-task-state

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

FAQPage Schema
How do I save task progress so it survives between AI sessions?

Describe your progress in natural language and the Skill writes it into task files under .codex/tasks/ in the project. Each record captures current conclusions, blockers, recovery entry points, and next steps for later resumption.

How to track interrupted work when a fix breaks my main task?

Short fixes are recorded as checkpoint entries in the main task's interruption log rather than as new tasks. Only independent, multi-session insertions get their own task file, keeping the task list clean.

What task statuses does this task tracking workflow support?

It supports eight states: requirement, pending, in-progress, interrupted, blocked, awaiting-resume, completed, and cancelled. Completed and cancelled tasks are moved into .codex/tasks/archived/ to keep the active directory focused.

What happens if the project tasks directory is not writable?

The Skill first attempts the platform's native approval flow to gain write access. Only if the project directory remains unwritable after approval does it fall back to ~/.codex/tasks/ and clearly report the fallback reason.

When should I not use this task state skill?

Do not use it to implement features, fix bugs, or diagnose configuration status. Those cases are delegated to the new-feature, fix, and cc-status skills respectively; this Skill only persists task state.