Implement opsx-render Command

Render OpenSpec spec.md and tasks.md files from current TD task management state.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the synchronization of specification documents (spec.md) and task lists (tasks.md) with the current state of a task management system (TD), ensuring documentation accurately reflects the live project status.

Core Features & Use Cases

  • Automated Document Rendering: Renders spec.md and tasks.md based on TD task management data.
  • Filesystem Synchronization: Keeps project documentation in sync with the TD state.
  • Traceability Maintenance: Preserves and validates task IDs across documentation and TD.
  • Use Case: After updating task statuses in TD, running this Skill ensures that the spec.md and tasks.md files are automatically updated to reflect the latest progress, requirements, and task completion status.

Quick Start

Run the opsx-render command to synchronize your openspec documents with the current TD state.

Frequently Asked Questions about Implement opsx-render Command

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

FAQPage Schema
How do I sync spec.md and tasks.md with TD task management state?

To sync spec.md and tasks.md with TD task management state, run the opsx-render command to automatically render OpenSpec artifacts from current TD data. This updates documentation to reflect live project status, preserving requirement IDs and task statuses.

What is OpenSpec artifact rendering from TD task management data?

OpenSpec artifact rendering generates spec.md and tasks.md files from current TD task management data. This process synchronizes filesystem documentation with live TD state, ensuring accurate requirement traceability and task status updates across project files.

How does opsx-render handle task ID preservation during document synchronization?

Opsx-render preserves task IDs during synchronization by validating and maintaining requirement identifiers across spec.md, tasks.md, and TD state. This ensures traceability is maintained while updating task statuses and rendering current project documentation.

Does opsx-render support atomic writes for data integrity?

Yes, opsx-render supports atomic writes to ensure data integrity when rendering spec.md and tasks.md files. This prevents partial file updates during synchronization with TD state, protecting documentation accuracy during automated rendering operations.

When do I need to render OpenSpec documents from TD state?

You need to render OpenSpec documents when TD task statuses change and spec.md or tasks.md files must reflect current progress. Running opsx-render after TD updates ensures documentation accurately mirrors live project state, requirements, and completion status.

Can I use opsx-render for GitOps documentation sync without manual file updates?

Yes, opsx-render automates GitOps documentation sync by rendering spec.md and tasks.md directly from TD state. This eliminates manual file updates, ensuring filesystem documentation stays synchronized with TD task management data automatically.