archive-task

Update todo.md and changelog.md in a single atomic Git commit.

4|Updated Sep 25, 2025
One-click install
npx skills add https://github.com/cowwoc/styler --skill archive-task
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archive-task
Source: https://github.com/cowwoc/styler/tree/main/.claude/skills/archive-task
Command: npx skills add https://github.com/cowwoc/styler --skill archive-task

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually updating todo.md and changelog.md after a task is completed can lead to fragmented commits or missed updates, making project tracking inconsistent. This Skill ensures these critical updates are performed atomically and correctly, saving time and maintaining project integrity.

Core Features & Use Cases

  • Atomic Updates: Marks a task as complete in todo.md and adds an entry to changelog.md in a single Git commit.
  • Validation: Verifies the task is in a COMPLETE state and has been merged to main before archiving.
  • Changelog Formatting: Automatically formats new entries with date, task name, and extracted changes.
  • Change Extraction: Can automatically extract changes from the merge commit message for the changelog.
  • Use Case: After a feature has been successfully merged to main, use this Skill to automatically update your project's todo.md (marking the task complete) and changelog.md (documenting the changes), ensuring your project documentation is always up-to-date and consistent.

Quick Start

After your task is merged to 'main', archive it: TASK_NAME="implement-formatter-api" CHANGES="Added FormattingRule interface Implemented RuleEngine class" /workspace/main/.claude/scripts/archive-task.sh
--task "$TASK_NAME"
--changes "$CHANGES"

Frequently Asked Questions about archive-task

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

FAQPage Schema
How do I automatically update todo.md and changelog.md when a task is completed?

This Skill automates atomic updates to both files in a single Git commit when a task reaches COMPLETE status and is merged to main. It validates preconditions, marks the task complete in todo.md, formats and adds an entry to changelog.md, then commits both changes together to avoid fragmented commits.

Can I keep my todo list and changelog synchronized without manual commits?

Yes. This Skill ensures todo.md and changelog.md stay synchronized by performing both updates atomically in one commit. It eliminates the risk of missed updates or inconsistent project tracking that occurs when these files are edited separately.

What validation happens before archiving a task?

The Skill verifies the task is in COMPLETE state and has been merged to main before proceeding. This precondition validation prevents archiving incomplete or unmerged work and guarantees changelog entries reflect only shipped changes.

How does changelog formatting work when archiving tasks?

The Skill automatically formats new changelog entries with the date, task name, and extracted changes from the merge commit message. You can supply changes directly or let it parse them from the commit, then it adds the formatted entry to changelog.md.

Why use atomic commits for task archival instead of separate updates?

Atomic commits prevent split commits where todo.md and changelog.md get out of sync if one update fails or is reverted. A single commit guarantees both files reflect the task status consistently and project documentation remains reliable.

Can I use this workflow with Git-based project tracking?

Yes. This Skill integrates with Git workflows where tasks are tracked in todo.md, changes are documented in changelog.md, and completed work is merged to main. It fits teams using Git for version control and file-based documentation.