Fossil Record is a git archaeology engine that reconstructs the evolutionary pressures and technical decisions that shaped your codebase into its current form.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install fossil-record
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 fossil-record 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 Fossil Record?
Fossil Record transforms the way developers interact with version history by applying a geological model to git analysis. While traditional tools focus on what changed, this tool for Openclaw Skills investigates why changes occurred by reading commit history like sediment layers. It identifies the forces—such as deadline pressure, technical debt, and stakeholder demands—that have left permanent marks on the architecture.
By treating a repository as a geological record, Fossil Record helps teams understand the survival history of their software. It provides deep context for Openclaw Skills users by mapping out eras of development, identifying architectural fault lines, and highlighting extinct modules that may still leave behind digital artifacts in the current system.
Fossil Record Use Cases
- Perform a full geological survey when joining a new project to understand historical context.
- Reconstruct decision trees before modifying legacy code to avoid repeating past mistakes.
- Conduct pressure analysis after major incidents to see how emergency hotfixes impacted code quality.
- Map knowledge voids during team transitions to identify areas where original authors have departed.
- Generate evolutionary narratives for onboarding new developers into the ecosystem of Openclaw Skills.
How Fossil Record Works
- The engine scans the entire git history, analyzing commit patterns, revert sequences, and branch metadata.
- It applies a change taxonomy to classify modifications as bug fixes, feature accretion, config churn, or refactor oscillations.
- The system identifies major architectural shifts (fault lines) by tracking large-scale rename operations and dependency replacements.
- It reconstructs the decision-making lifecycle by tracing abandoned approaches and sequential implementations of the same feature.
- Finally, it generates a Geological Survey report that forecasts the future trajectory of the codebase based on historical momentum.
Fossil Record Setup
Fossil Record is designed as a zero-dependency cognitive tool for Openclaw Skills. It requires only a local git repository to function. To integrate this skill into your environment, use the following command:
openclaw install fossil-record
Ensure you are within a git-initialized directory before invoking the excavation modes.
Fossil Record Data Schema & Taxonomy
The skill organizes findings based on a geological metadata taxonomy to clarify the state of the codebase:
| Geological Concept | Technical Equivalent |
|---|---|
| Sediment Layers | Periods of steady feature development and stable commits |
| Fault Lines | Major architectural shifts, rewrites, or directory restructuring |
| Impact Craters | Traces of incident responses, emergency hotfixes, and reverts |
| Fossil Beds | Stable modules or forgotten code that hasn't changed in over 18 months |
| Extinction Events | Deleted modules or abandoned features that may leave orphaned artifacts |
| Adaptive Radiation | Rapid diversification of code following a new abstraction or framework migration |
Fossil Record Advanced Features
- Pressure Analysis: Detects when deadline or stakeholder pressure caused drops in test coverage or increased hotfix frequency.
- Author Topology: Identifies knowledge monopolies and voids where critical modules are no longer supported by active contributors.
- Evolution Trajectory: Predicts upcoming architectural shifts and identifies modules at risk of calcification.
- Extinction Mapping: Traces deleted code to find orphaned database tables, API routes, or mock tests left behind by removed features.
- Decision Reconstruction: Rebuilds the logic behind rejected alternatives by analyzing abandoned branches and reverted commits within the context of Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Error Rosetta
A universal translator that converts complex compiler errors and stack traces into actionable plain-language fixes.
Dungeon Debug
Dungeon Debug transforms technical debugging sessions into an immersive text-based RPG dungeon crawl to ensure systematic error resolution.
Dream State
A lateral thinking engine that solves complex engineering problems by mapping solution patterns from unrelated domains like biology, music, and physics onto technical challenges.
Dependency Autopsy
A comprehensive health examination tool for your dependency tree that evaluates risk beyond simple version checks.
Inversion Protocol
The Inversion Protocol is a zero-dependency meta-cognitive layer that enhances AI agent decision-making through backwards-thinking logic.
Loot Drop
Gamify your coding experience by earning RPG-style loot drops and building a developer inventory based on your real-world technical achievements.
Featured*
