OpenParable
Skip to content
← Back to skills

Tasks Sync

Productivity
tasks-sync

Tasks Sync is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

This skill should be used when syncing current session tasks to a project directory. It exports all tasks from the current Claude Code session to JSON files in the project's tasks directory, enabling persistence across sessions.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/productivity/tasks-sync-codyswanngt-lisa-2/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/tasks-sync, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Sync Tasks to Project

Sync all tasks from the current session to projects/$ARGUMENTS/tasks/{session-id}/.

This skill is for manual syncing when work started without setting an active project. Once synced, the automatic hook handles future task updates.

Process

Step 1: Validate Project

Check if the project directory exists:

ls -d projects/$ARGUMENTS 2>/dev/null

If the project doesn't exist, ask: "Project '$ARGUMENTS' doesn't exist. Create it?"

If yes, create the project structure:

mkdir -p projects/$ARGUMENTS/tasks

Step 2: Determine Session ID

Find the current session by looking for the most recently modified task directory:

ls -dt ~/.claude/tasks/*/ 2>/dev/null | head -1 | xargs basename

If no session found, use a timestamp-based identifier:

echo "manual-$(date +%Y%m%d-%H%M%S)"

Store the session ID for use in subsequent steps.

Step 3: Set Active Project

Create/update the active project marker:

echo "$ARGUMENTS" > .claude-active-project

Step 4: Get Current Tasks

Use TaskList to get all tasks in the current session.

Step 5: Sync Each Task

For each task from TaskList:

  1. Use TaskGet to get full task details
  2. Create the session directory:
mkdir -p projects/$ARGUMENTS/tasks/{session-id}
  1. Create a JSON file with the task data:
{
  "id": "<task-id>",
  "subject": "<subject>",
  "description": "<description>",
  "activeForm": "<activeForm>",
  "status": "<status>",
  "blocks": [],
  "blockedBy": []
}
  1. Write to projects/$ARGUMENTS/tasks/{session-id}/<id>.json

Step 6: Stage for Git

git add projects/$ARGUMENTS/tasks/{session-id}/*.json

Step 7: Report

Synced X tasks to projects/$ARGUMENTS/tasks/{session-id}/
- Pending: Y
- In Progress: Z
- Completed: W

Files staged for commit. Run /git-commit when ready.

Notes

  • This skill manually syncs all current tasks to a project
  • Use this when work started without a project context
  • After syncing, the active project is set so future tasks auto-sync via the hook
  • Each sync creates a new session directory to preserve history