Skip to content
Development
Skill

/save-task-list

Save current task list for reuse across sessions

From plugin
archon
23k14 skills13 agents19 commands
Install
$ npx -y skills add coleam00/Archon --skill save-task-list --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/save-task-list

Context preview

The summary Claude sees to decide when to auto-load this skill.

Save current task list for reuse across sessions

SKILL.md

save-task-list.SKILL.md
name: save-task-list
description: Save current task list for reuse across sessions
disable-model-invocation: true
hooks:
  Stop:
    - hooks:
        - type: prompt
          prompt: |
            A skill just finished saving a task list for session reuse.
            Evaluate the assistant's final message below.

            $ARGUMENTS

            Verify:
            1. A task list ID was found and displayed
            2. A startup command (CLAUDE_CODE_TASK_LIST_ID=<id> claude) was provided
            3. A task summary was shown

            Return {"ok": true} if all three are present.
            Return {"ok": false, "reason": "Missing: <what>"} if anything is missing.
          statusMessage: "Verifying task list was saved..."
  PostToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "jq -r '[.tool_name, .tool_input.command // \"n/a\"] | join(\": \")' | head -1"
          statusMessage: "Logging tool use..."
          once: true

Save Task List for Reuse

Save the current session's task list so it can be restored in future sessions.

Session Context

  • **Session ID**: ${CLAUDE_SESSION_ID}
  • **Active task directories**: !`ls -1t ~/.claude/tasks/ 2>/dev/null | head -5 || echo "none found"`
  • **Current tasks in session**: !`ls -1t ~/.claude/tasks/ 2>/dev/null | head -1 | xargs -I{} ls ~/.claude/tasks/{} 2>/dev/null | head -10 || echo "no tasks"`

---

Instructions

1. **Find the current task list ID** by checking `~/.claude/tasks/` for the most recently modified directory. List the directories sorted by modification time.

2. **Verify the match** — read the task files inside the directory and compare them to any tasks you know about from this session. Confirm you have the correct task list.

3. **Log the session mapping** — write the mapping to `.claude/archon/sessions/`:

   mkdir -p .claude/archon/sessions
   echo '{"session": "${CLAUDE_SESSION_ID}", "task_list": "<TASK_LIST_ID>", "saved_at": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}' \
     >> .claude/archon/sessions/task-lists.jsonl

4. **Verify the SessionStart hook is installed** — the project-level `.claude/settings.json` already includes a SessionStart hook that runs `verify-task-list.sh` on every session start. Confirm it's present by reading the file. If it's missing for some reason, add it back:

   {
     "hooks": {
       "SessionStart": [
         {
           "hooks": [
             {
               "type": "command",
               "command": ".claude/skills/save-task-list/hooks/verify-task-list.sh",
               "statusMessage": "Checking for restored task list..."
             }
           ]
         }
       ]
     }
   }

**Important**: Merge — don't overwrite existing settings. If `hooks` or `SessionStart` already exists, append to the array. If the hook is already installed, skip this step.

5. **Output the startup command** for the user:

   To continue with this task list in a new session:

   CLAUDE_CODE_TASK_LIST_ID=<task_list_id> claude

Explain: On startup, the SessionStart hook will verify the task list exists and show a confirmation message.

6. **Show the current task summary** so the user knows what's preserved (task subjects, statuses, and any dependencies).

Read more
Ships witharchon

The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.

Get the whole plugin

Other skills on archon.