progress-files

Read past progress files to resume work across sessions.

2|1|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/masseater/claude-code-plugin --skill progress-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: progress-files
Source: https://github.com/masseater/claude-code-plugin/tree/main/plugins/mutils/skills/progress-files
Command: npx skills add https://github.com/masseater/claude-code-plugin --skill progress-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides you to reference and read past session progress files stored under .agents/progress/*.md to resume work, recall decisions, and pick up tasks from where you left off.

Core Features & Use Cases

  • Progress lookup: List and read the latest progress files sorted by timestamp.
  • Keyword search: Find past notes using keywords to locate relevant context.
  • Semantic search (optional): Use semtools to semantically search progress files for related concepts.

Quick Start

Reference the latest progress file to continue your current task.

Frequently Asked Questions about progress-files

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

FAQPage Schema
How do I resume work from where I left off in a previous session?

Resume work by referencing past progress files stored in .agents/progress/ directory. The Skill retrieves your latest session notes sorted by timestamp, letting you quickly recall decisions, pick up interrupted tasks, and continue without losing context.

Can I search through my past session notes to find relevant work?

Yes. The Skill supports keyword search across progress files to locate specific context, and optional semantic search via semtools to find related concepts and TODOs from prior sessions, making it easy to discover relevant past work.

What file format and storage structure do progress files require?

Progress files must be stored as Markdown (.md) files in .agents/progress/ with timestamps in YYYY-MM-DD_HH-MM-SS.md format. This structure enables chronological sorting and reliable retrieval across sessions.

How do I set up progress file storage for session continuity?

Create a .agents/progress/ directory in your local environment and store session notes as timestamped Markdown files. The Skill automatically reads, sorts, and searches these files to preserve continuity between work sessions.

Can I perform semantic searches across my progress notes?

Yes, the Skill supports semantic search through semtools integration, allowing you to search progress files by concept and meaning rather than exact keywords, surfacing contextually related prior work and decisions.