coordinator-task-status-renderer

Render and seed OpenSpec task status blocks from labeled coordinator issues.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/jankneumann/agentic-assistant --skill coordinator-task-status-renderer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coordinator-task-status-renderer
Source: https://github.com/jankneumann/agentic-assistant/tree/main/.agents/skills/coordinator-task-status-renderer
Command: npx skills add https://github.com/jankneumann/agentic-assistant --skill coordinator-task-status-renderer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires coordination_bridge, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates manual, error-prone upkeep of the coordinator-owned task status block inside OpenSpec change documentation.

Core Features & Use Cases

  • Render coordinator task status blocks: Rewrites the managed block in each change’s tasks.md based on coordinator issue state (including assignee/status annotations and blocked-on upstreams).
  • Seed coordinator tasks from hand-authored markdown: Parses human-authored task lines from tasks.md (with optional Dependencies) and creates idempotent coordinator issues labeled with change/task keys.
  • Fail-safe idempotency and safety guards: Validates change-id format, prevents path traversal, handles coordinator timeouts/unreachability via a persisted stale marker, and refuses to seed when the coordinator response is truncated.

Quick Start

Have your AI run the rendering step for a change by invoking the script command scripts/render_tasks_status.py <change-id>.

Frequently Asked Questions about coordinator-task-status-renderer

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

FAQPage Schema
How do I keep OpenSpec tasks.md in sync with coordinator issue state?

To keep OpenSpec tasks.md in sync with coordinator issue state, you can run a rendering script that reads labeled issues and rewrites the managed GENERATED block in openspec/changes/<change-id>/tasks.md automatically.

Can I seed coordinator tasks from manually authored markdown in OpenSpec?

Yes, you can seed coordinator tasks from manually authored markdown by parsing human-authored task lines and dependencies, then creating idempotent coordinator issues labeled with change and task keys.

What happens when the coordinator is unreachable during OpenSpec task rendering?

When the coordinator is unreachable during OpenSpec task rendering, the script handles timeouts via a persisted stale marker in sidecar state to maintain fail-safe behavior without crashing the documentation workflow.

Do I need a specific change-id format to render OpenSpec task status blocks?

Yes, you need a valid change-id format to render OpenSpec task status blocks. The script validates the change-id format and includes safety guards to prevent path traversal during file access.

How does the coordinator task status renderer prevent duplicate issue creation?

The coordinator task status renderer prevents duplicate issue creation through fail-safe idempotency, refusing to seed new issues when the coordinator response is truncated and ensuring issues are only created once per task key.

Why does my OpenSpec tasks.md generated block show stale task status?

Your OpenSpec tasks.md generated block shows stale task status when the coordination_bridge reports timeouts or unreachability, triggering a persisted stale marker that preserves existing data until the connection is restored.