spec-updater

Update phase statuses, tasks, and notes in Markdown specification files.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fractary/claude-plugins --skill spec-updater
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-updater
Source: https://github.com/fractary/claude-plugins/tree/main/plugins/spec/skills/spec-updater
Command: npx skills add https://github.com/fractary/claude-plugins --skill spec-updater

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Updates specifications with completed phases, checked tasks, and notes, enabling progress visibility and changeloging.

Core Features & Use Cases

  • Update phase status and tasks
  • Append implementation notes
  • Create changelog entries within the spec

Quick Start

Batch-update a phase as complete and add a progress note.

Frequently Asked Questions about spec-updater

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

FAQPage Schema
How do I automate updates to specification files during development?

Automate spec updates by marking phases complete, checking off tasks, and appending implementation notes directly in Markdown spec files. spec-updater handles in-place edits with atomic updates, validating file structure before writing to ensure changelog and progress visibility throughout your build phases.

Can I batch-update multiple tasks and phases in a specification at once?

Yes, batch-update enables you to mark multiple tasks complete, update phase status, and add implementation notes in a single operation. The Skill processes all changes atomically and returns confirmation, supporting one-phase-per-session workflows.

What happens if my spec file structure is invalid when I try to update it?

spec-updater validates file existence and Markdown structure before applying any changes. If validation fails, the operation is rejected without modifying the file, protecting your spec from malformed edits.

How do I add progress notes and changelog entries directly into my feature spec?

Use the add-implementation-notes operation to append notes to phase sections, creating an integrated changelog within your spec. Notes are added in-place during build checkpoints, keeping progress history alongside task tracking.

Does spec-updater work with bash scripts and command-line tools?

Yes, spec-updater is built on bash and jq, exposing operations via command-line interface. It integrates into build pipelines and scripts for automated checkpoint-driven specification updates.

What's the best way to track task completion across multiple spec documents?

Use check-task and check-all-tasks operations to mark tasks complete within spec sections. The Skill validates and updates each file atomically, enabling you to maintain consistent task-tracking state across your specification suite.