bulk-complete

abdullahbeam's avatarfrom abdullahbeam

Bulk-complete tasks/steps in a project. Load when user says "bulk complete [project]", "mark all done", "complete phase X", or needs to finish project tasks efficiently. Works with both steps.md and tasks.md formats.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025

When & Why to Use This Skill

The Bulk-Complete Claude skill is a productivity-focused tool designed to automate the management of project task lists. It enables users to efficiently mark multiple steps or entire phases as completed within markdown files (steps.md or tasks.md) using natural language commands. By streamlining the documentation of project progress, it ensures that task tracking remains accurate and up-to-date with minimal manual intervention, making it an essential utility for developers and project managers using AI agents.

Use Cases

  • Phase Completion: Quickly mark all tasks within a specific project milestone, such as 'Phase 2' or 'Section 3', as finished to reflect current progress.
  • Project Finalization: Automatically update all remaining tasks to completed status when a project is concluded, ensuring documentation is perfectly synced with the final state.
  • Selective Batch Updates: Efficiently mark a specific range of tasks (e.g., tasks 1-5 and 10-15) as done after completing a focused work session.
  • Automated Session Closing: Integrate with session-end workflows to auto-complete tasks, maintaining a clean and accurate project history without manual editing.
namebulk-complete
descriptionBulk-complete tasks/steps in a project. Load when user says "bulk complete [project]", "mark all done", "complete phase X", or needs to finish project tasks efficiently. Works with both steps.md and tasks.md formats.

Bulk Complete

Efficiently mark tasks complete in project steps.md files.

When to Use

  • User says "bulk complete [project]" or "mark all tasks done"
  • User says "complete Phase 2" or "finish Section 3"
  • Project work is done, need to mark all steps [x]
  • During close-session if project complete (auto-triggered)

Quick Start

Auto-detect and run:

python scripts/bulk-complete.py --project [ID] --all --no-confirm

Usage Patterns

Complete all tasks (project finished):

python scripts/bulk-complete.py --project 01 --all --no-confirm

Complete specific phase (phase done):

python scripts/bulk-complete.py --project 01 --section "Phase 2"

Complete task range (selective):

python scripts/bulk-complete.py --project 01 --tasks 1-5,7,10-15

Interactive mode (pick tasks):

python scripts/bulk-complete.py --project 01

Script Details

  • Auto-detects: steps.md (new) OR tasks.md (legacy)
  • Validates: Re-reads file to confirm completion
  • Cross-platform: Works on Windows, Mac, Linux
  • Tested: 27 unit tests, 100% passing

Run python scripts/bulk-complete.py --help for all options.


Integration: Used by close-session skill (Step 2 auto-complete)