openspec-td-sync

Synchronize td task states into OpenSpec tasks.md artifacts.

1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/em-jones/staccato-toolkit --skill openspec-td-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-td-sync
Source: https://github.com/em-jones/staccato-toolkit/tree/main/.opencode/skills/openspec-td-sync
Command: npx skills add https://github.com/em-jones/staccato-toolkit --skill openspec-td-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill synchronizes task states between the td (task management) tool and the openspec (spec-driven development) filesystem, ensuring consistency and providing human-readable artifacts.

Core Features & Use Cases

  • Source of Truth: Keeps td as the authoritative task tracker.
  • Human-Readable Artifacts: Generates and updates tasks.md in the OpenSpec format.
  • Agent Handoffs: Facilitates seamless transitions between agents or sessions by including synchronized OpenSpec context.
  • Auditing: Enables easy comparison of planned work versus actual progress.

Quick Start

Use the openspec-td-sync skill to update the tasks.md file for the 'auth-feature' change.

Frequently Asked Questions about openspec-td-sync

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

FAQPage Schema
How do I sync tasks from td to the OpenSpec filesystem?

To sync tasks from the td task management system to an OpenSpec format, you query td for issues, epics, and decisions, then format this data into an OpenSpec artifact like tasks.md to maintain synchronization with the actual work state.

What is the OpenSpec format used for in task management?

The OpenSpec format is used for generating human-readable artifacts like tasks.md from task management data. It preserves a readable spec-driven development filesystem while keeping the td CLI as the authoritative task tracker.

Can I use td CLI as the source of truth while keeping documentation updated?

Yes, you can use the td CLI as the source of truth while keeping documentation updated by synchronizing task states to the OpenSpec format. This updates human-readable artifacts and maintains filesystem consistency with actual work progress.

How do I audit planned work versus actual progress in spec-driven development?

You audit planned work versus actual progress in spec-driven development by comparing OpenSpec filesystem artifacts, like tasks.md, against the synchronized task states queried directly from the td task management system.

Does openspec-td-sync work without dependencies for agent handoffs?

Yes, openspec-td-sync works without external dependencies for agent handoffs. It facilitates seamless transitions between agents or sessions by including synchronized OpenSpec context generated from the queried td task data.