refresh

Verify and update checklist status and phase markers in spec plans.

Updated Nov 15, 2025
One-click install
npx skills add https://github.com/cloudvoyant/claudevoyant --skill refresh-cloudvoyant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refresh
Source: https://github.com/cloudvoyant/claudevoyant/tree/main/plugins/spec/skills/refresh
Command: npx skills add https://github.com/cloudvoyant/claudevoyant --skill refresh-cloudvoyant

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures your project plans accurately reflect their current progress by verifying and updating task completion statuses and phase markers.

Core Features & Use Cases

  • Automated Status Verification: Checks if phase completion markers (✅) align with actual task completion.
  • Status Synchronization: Updates phase markers to accurately reflect completed tasks.
  • Progress Reporting: Provides a clear summary of plan progress, including task completion percentages and branch context.
  • Use Case: After completing several tasks within a project plan, run this Skill to automatically update the plan's documentation, ensuring everyone sees the latest progress and any potential branch mismatches are flagged.

Quick Start

Run the refresh skill to update the status of the current plan.

Frequently Asked Questions about refresh

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

FAQPage Schema
How do I update plan status to reflect completed tasks?

To update plan status, run a refresh to verify task completion and automatically synchronize phase markers with actual progress. It analyzes the plan, extracts branch context, and reports completion percentages.

Why are my project spec phase markers out of sync with task completion?

Phase markers fall out of sync when tasks are completed without updating the spec plan. Running a status refresh verifies checklist completion and automatically aligns phase markers to reflect actual progress.

What's the best way to sync plan progress after completing several tasks?

The best way to sync plan progress is to trigger a plan refresh, which analyzes the current worktree context, verifies checklist status, and updates phase markers to accurately report completion.

Can I check if my branch context matches the current plan progress?

Yes, you can verify branch context by refreshing the spec plan. The process extracts branch and worktree information, checks it against task completion, and flags any inconsistencies or mismatches.

How does automated status verification work for project checklists?

Automated status verification works by analyzing the spec plan to check if phase completion markers align with actual task completion. It then updates the documentation and reports any inconsistencies.

When should I refresh my spec plan to update progress?

You should refresh your spec plan to update progress after completing several tasks within a project plan. This ensures documentation accurately reflects the latest status and flags any branch mismatches.