One-click install
npx skills add https://github.com/tylerburleigh/claude-sdd-toolkit --skill sdd-update
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-update
Source: https://github.com/tylerburleigh/claude-sdd-toolkit/tree/main/skills/sdd-update
Command: npx skills add https://github.com/tylerburleigh/claude-sdd-toolkit --skill sdd-update

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the administrative burden of project management by automating progress tracking, decision journaling, and lifecycle management for Spec-Driven Development (SDD) JSON files. It ensures your specifications are always up-to-date, reflecting the true state of development and fostering transparency.

Core Features & Use Cases

  • Automated Status Updates: Mark tasks and phases as pending, in_progress, completed, or blocked, with automatic progress recalculation.
  • Comprehensive Journaling: Add timestamped entries for decisions, deviations, blockers, and notes directly into the JSON spec.
  • Lifecycle Management: Move specs between active, completed, and archived folders, and update spec-level metadata.
  • Use Case: As you complete a task, use this skill to mark it completed, add a journal entry documenting any deviations from the original plan, and then check the overall status-report to see how your progress impacts the entire project.

Quick Start

Mark a task as in progress

sdd update-status user-auth-001 task-1-2 in_progress --note "Starting User model implementation"

Mark a task as completed, automatically running associated verifications

sdd update-status user-auth-001 task-1-2 completed --note "User model finished and tested" --verify

Add a journal entry for a deviation from the plan

sdd add-journal user-auth-001 --title "Deviation: UUID Primary Keys" --content "Switched to UUIDs for primary keys for better distribution." --task-id task-1-2 --entry-type deviation

Get a summary of overall progress and status

sdd status-report user-auth-001

Frequently Asked Questions about sdd-update

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

FAQPage Schema
How do I automate task status updates in spec-driven development?

Task status updates in spec-driven development can be automated by marking tasks as pending, in_progress, completed, or blocked with CLI commands that automatically recalculate project progress and record timestamps in your JSON specs.

Can I track project progress and document decisions in JSON specs automatically?

Yes, progress tracking and decision journaling can be automated by adding timestamped entries for decisions, deviations, and blockers directly into JSON spec files, with automatic metadata updates and backup creation.

What's the best way to manage spec lifecycle from active to completed status?

Spec lifecycle management moves specifications between active, completed, and archived folders while updating spec-level metadata and enforcing non-structural changes through validated CLI commands.

How do I journal deviations from the original development plan?

Deviations from the plan can be recorded as timestamped journal entries linked to specific tasks, capturing the reasoning and impact while maintaining the spec's audit trail without structural modifications.

Do I need to manually recalculate project progress after task updates?

No, project progress is automatically recalculated when task statuses are updated, eliminating manual computation and ensuring your status reports always reflect the current development state.