context-resume

Loads plugin context from handoff files, parses YAML frontmatter and markdown, and routes to continuation skills.

2|Updated Nov 18, 2025
One-click install
npx skills add https://github.com/bretbouchard/plugin-freedom-system --skill context-resume-bretbouchard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-resume
Source: https://github.com/bretbouchard/plugin-freedom-system/tree/main/.claude/skills/context-resume
Command: npx skills add https://github.com/bretbouchard/plugin-freedom-system --skill context-resume-bretbouchard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Managing complex, multi-stage software development can lead to losing track of progress, especially after breaks. This skill ensures seamless continuity by locating and interpreting handoff files, presenting a clear summary of your last session, and routing you directly to the next logical step in your workflow.

Core Features & Use Cases

  • Intelligent Handoff Location: Automatically finds your .continue-here.md files across multiple possible locations for any plugin, providing disambiguation if necessary.
  • Contextual Summary: Parses YAML metadata and Markdown body to provide a human-readable overview of your stage, status, completed work, and next steps, including "time-ago" calculations.
  • Smart Workflow Routing: Delegates to the appropriate continuation skill (e.g., plugin-workflow, plugin-ideation, ui-mockup) with all necessary context loaded, based on the identified stage.
  • Error Recovery: Gracefully handles missing, corrupted, or stale handoff files, offering reconstruction options from Git history to prevent data loss.
  • Use Case: Return to your 'FilterFX' plugin after a week's break. Instead of manually figuring out where you were, simply type /continue FilterFX, and the AI will tell you, "Resuming FilterFX at Stage 2 (Audio Engine Working)... Last session: 7 days ago. Next: Implement filtering algorithm."

Quick Start

Continue working on my 'SynthPad' plugin.

Frequently Asked Questions about context-resume

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

FAQPage Schema
How do I resume work on a project after taking a break?

Resume work by loading your handoff file, which contains saved context from your last session. The Skill locates your `.continue-here.md` file, parses its metadata and notes, displays a summary of your stage and progress, and routes you to the next workflow phase automatically.

What information does a handoff file store about my workflow?

Handoff files store YAML frontmatter with metadata (stage, status, timestamps) and a Markdown body with completed work, blockers, and next steps. This context enables seamless continuation without manually reconstructing your progress or decisions.

Can the Skill find handoff files in multiple project locations?

Yes, the Skill searches across multiple possible locations for `.continue-here.md` files and provides disambiguation when multiple handoffs exist, ensuring you always locate the correct context for your plugin or project.

What happens if my handoff file is missing or corrupted?

The Skill gracefully handles missing or corrupted handoff files and offers recovery options, including reconstruction from Git history, to prevent data loss and keep your workflow uninterrupted.

How does the Skill determine which phase to continue into?

After parsing your handoff file, the Skill identifies your current stage and routes you to the appropriate continuation skill—workflow, ideation, mockup, or improvement—with all necessary context preloaded for immediate work resumption.

When should I use context handoffs instead of manual notes?

Use handoff files for multi-stage projects with interruptions or team transitions. They automate context recovery, timestamp your sessions for time-ago tracking, and ensure structured continuation, reducing cognitive overhead and preventing progress loss.