When is the best time to run the refresh-claude skill?

You should run it after adding major features, completing significant refactors, or installing new tools and dependencies that change your workflow.

How does it detect changes in my project?

It uses a combination of git log analysis, directory scanning, and configuration file inspection to identify new scripts, file structures, and architectural patterns.

Why should I update my CLAUDE.md file?

CLAUDE.md serves as the primary persistent context for Claude Code; keeping it updated ensures the AI uses the correct commands and follows current project conventions.

Does this skill delete my manual notes in CLAUDE.md?

The skill is designed to perform targeted updates, adding new patterns and removing demonstrably outdated information while preserving the overall utility of the document.

Claude Context Refresher

Name: Claude Context Refresher
Author: zbruhnke

byzbruhnke

•

Productivity & Workflow

Maintains project-wide context by automatically updating CLAUDE.md with recent architectural changes, new patterns, and updated commands.

About

The Refresh Claude skill ensures that your persistent project context remains accurate and actionable as your codebase evolves. By analyzing recent git history, scanning for new dependencies, and identifying emerging coding patterns, it keeps the CLAUDE.md file synchronized with the actual state of the project. This prevents Claude from relying on outdated information, reduces token waste on stale context, and streamlines the transition between development sessions.

Key Features

Generates a summary of all context updates and discovered patterns
Analyzes recent Git commits and diffs to detect architectural shifts
Identifies and removes obsolete conventions or deprecated file paths
9 GitHub stars
Scans for new configuration files, dependencies, and script commands
Standardizes project documentation to focus on actionable, tool-enforced patterns

Use Cases

Updating project context after major refactors or adding new feature modules
Synchronizing documentation after migrating to new frameworks or testing libraries
Periodic maintenance to ensure Claude understands current project-specific workflows

About

Key Features

Generates a summary of all context updates and discovered patterns
Analyzes recent Git commits and diffs to detect architectural shifts
Identifies and removes obsolete conventions or deprecated file paths
9 GitHub stars
Scans for new configuration files, dependencies, and script commands
Standardizes project documentation to focus on actionable, tool-enforced patterns

Use Cases

Updating project context after major refactors or adding new feature modules
Synchronizing documentation after migrating to new frameworks or testing libraries
Periodic maintenance to ensure Claude understands current project-specific workflows