A change intelligence tool that predicts the ripple effects and propagation paths of code modifications before they happen.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install seismograph
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install seismograph using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Seismograph?
Seismograph is a sophisticated impact analysis skill designed to map how code modifications propagate through a codebase. Much like a geological seismograph tracks energy radiating from an epicenter, this tool identifies how a single line change can affect functions, modules, tests, and downstream systems. It provides developers with a clear vision of the potential magnitude of their changes, moving beyond simple IDE "find references" to reveal hidden dependencies and side effects.
By incorporating this into your library of Openclaw Skills, you gain the ability to anticipate breaking changes in APIs, database schemas, and even external webhooks. Seismograph focuses on preventing surprises by ensuring that every "simple change" is backed by a rigorous assessment of its seismic reach across the entire technical landscape, identifying not just what calls a function, but what assumptions and side effects are relied upon throughout the system.
Seismograph Use Cases
- Before modifying public interfaces, shared types, or API signatures to identify potential P-Wave breakages.
- Assessing the risk of renaming fields that cross module or service boundaries.
- Validating the safety of removing functions or parameters during refactoring to avoid S-Wave integration failures.
- Analyzing database schema changes or wire format modifications that might cause Surface Wave incidents in production.
- Conducting thorough PR reviews to ensure the proposed change accounts for its full architectural impact.
How Seismograph Works
- Epicenter Mapping: Identifies the exact lines being changed and classifies the risk based on the change type (rename, implementation, or behavioral).
- P-Wave Analysis: Traverses the static dependency graph to find immediate callers and consumers that will break at compile time.
- S-Wave Analysis: Traces transitive dependencies and data flows up to 3 hops away to identify runtime or integration risks.
- Surface Wave Analysis: Scans for side-effect dependents such as event subscribers, log parsers, and monitoring rules.
- Fault Line Assessment: Evaluates if architectural boundaries are strong (typed contracts) or weak (duck typing) to determine if waves will be dampened or magnified.
- Report Generation: Outputs a comprehensive Magnitude and Intensity map with a recommended strategy (direct, staged, or reconsider).
Seismograph Setup
To integrate Seismograph into your development environment, ensure you are using a compatible agent that supports Openclaw Skills.
# Navigate to your project root
cd /your/project/path
# Install the seismograph skill
openclaw install seismograph
# Run a pre-change analysis on a specific file
openclaw run seismograph --analyze src/models/user.ts
No external API keys are required, as the tool performs pure static and historical analysis on your local repository.
Seismograph Data Schema & Taxonomy
Seismograph organizes impact data based on a seismic metaphor to help developers prioritize fixes.
| Analysis Component | Description |
|---|---|
| Epicenter | The specific source file and line numbers of the proposed modification. |
| Magnitude Scale | A 1.0 to 7.0+ rating indicating the scope and reach of the change. |
| P-Waves | Direct impacts: imports, function calls, and immediate unit tests. |
| S-Waves | Indirect impacts: transitive importers and integration test suites. |
| Surface Waves | Silent impacts: webhooks, search indexes, and monitoring alerts. |
| Aftershock Forecast | An estimate of secondary bugs that may arise from fixing the primary breaks. |
Seismograph Advanced Features
- Predictive Aftershock Forecasting: Identifies if fixing a primary breakage will trigger a new cascade of necessary changes.
- Cross-System Trace: Detects impacts on external systems like Elasticsearch indexes, Zapier integrations, and webhook consumers.
- Architectural Dampening: Automatically identifies strong vs. weak boundaries to calculate the intensity of a change at different locations.
- Zero-Dependency Engine: Operates entirely through static analysis without requiring external API calls or runtime overhead.
SKILL.md
Loading
Related Openclaw Skills
Scope Sentinel
An intelligent session monitor that detects when you drift from your coding tasks and helps you maintain focus.
Rubber Duck Deluxe
An interactive debugging tool that uses distinct AI personalities to guide developers through the rubber duck debugging process.
Roast My Code
A merciless yet educational code roaster that destroys your bad code with humor then teaches you how to fix it.
Review Lens
Review Lens is a sophisticated code analysis tool that identifies deep logical errors, performance bottlenecks, and security risks that traditional human reviews often miss.
Speed Run
A gamification skill that applies speedrun mechanics like timer splits and personal bests to software engineering tasks.
Synaptic Pruning
Synaptic Pruning identifies and prepares the removal of vestigial code, fossilized configurations, and abandoned modules to mature your codebase.
Featured*
