ripple

Finds files referencing recently edited files and updates them together.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/hivgb1-ai/do-better-workspace-v2 --skill ripple-hivgb1-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ripple
Source: https://github.com/hivgb1-ai/do-better-workspace-v2/tree/main/.claude/skills/ripple
Command: npx skills add https://github.com/hivgb1-ai/do-better-workspace-v2 --skill ripple-hivgb1-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After editing a file in a workspace, related files such as catalogs, progress logs, and daily notes often become stale because their references are easy to miss. This Skill detects those related files and proposes the missing updates so nothing is left inconsistent. ## Core Features & Use Cases - Reference Discovery: Searches the workspace with Grep and Glob for files that mention the changed file, skill, agent, or project name, excluding archives and generated directories. - Structural and Time-Based Checks: Verifies skill and agent catalogs, locates project progress.md files by walking up folder trees, and checks today's daily note for recordable accomplishments. - Approval-Gated Updates: Presents an impact report table, asks which items to update, applies minimal edits, and can create a progress.md from a template when approved. - Use Case: After creating a new skill, run it to confirm the skill is registered in the skills catalog, the project progress log records the change, and today's daily note captures the accomplishment. ## Quick Start Ask the assistant to check for related files that need updating after your edits, for example by saying "find related files and update anything I missed".

Frequently Asked Questions about ripple

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

FAQPage Schema
How do I find files that reference a file I just edited?

Use a workspace-wide text search for the changed file's name or identifier, then filter results to exclude archives and generated directories. This Skill automates that search with Grep and Glob and presents matching files in an impact report table.

How to keep project progress logs updated after file changes?

Locate the progress.md in the project root folder by walking up from the changed file's directory, then append a timeline row and refresh the last-updated date. If no progress.md exists, one can be generated from a template at the project root.

Does this Skill modify files without asking?

No. It only proposes updates in a report and waits for explicit user approval through a confirmation prompt before editing any file. Approved changes are applied as minimal edits rather than rewrites.

What happens if the workspace is not a git repository?

The Skill falls back to using the current working directory as the workspace root when git rev-parse fails. Reference search and update logic work identically in non-git directories.

When does it update the daily note?

It updates the daily note only when a file for today's date already exists at the expected path, adding noteworthy accomplishments to the completed-work section. It never creates a new daily note on its own.