A diagnostic utility that translates technical codebase metrics like test coverage and complexity into an intuitive, metaphor-driven weather forecast.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install code-weather
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 code-weather 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 Code Weather?
Code Weather is a specialized diagnostic tool designed to provide developers with an atmospheric perspective on their repository's health. Instead of forcing teams to parse dense dashboards and abstract percentages, it synthesizes metrics—such as cyclomatic complexity, test pass rates, and bug density—into familiar weather patterns. This approach allows for instant cognitive processing of technical debt and project velocity using Openclaw Skills architecture.
By checking the forecast before writing code, developers can identify whether they are working in Clear Skies or heading into a Stormy module with critical security vulnerabilities. The tool is designed to be a zero-dependency, local-first utility that prioritizes privacy and speed, making it an essential addition to any developer's Openclaw Skills toolkit.
Code Weather Use Cases
- Daily morning check-ins to assess the atmospheric conditions of the codebase before starting development tasks.
- Sprint planning sessions to visualize which modules are currently under high pressure or experiencing a visibility drop.
- Team standups to provide a high-level health summary using intuitive metaphors rather than raw data points.
- Pre-deployment audits to check for severe weather alerts like Tornadoes (untested critical systems) or Tsunamis (breaking dependency changes).
How Code Weather Works
- The skill scans the local repository to extract key performance indicators, including test results, coverage reports, and linter outputs.
- It calculates the Temperature by applying a weighted average to metrics like test pass rates, coverage, and dependency health.
- It determines Sky Conditions by identifying the worst-performing quality metric to highlight immediate risks.
- It measures Wind and Pressure by analyzing commit velocity and the delta in cyclomatic complexity over the previous week.
- It compiles the data into a structured ASCII weather report, complete with regional module breakdowns and a 5-day forecast.
Code Weather Setup
To begin using Code Weather within your Openclaw Skills environment, follow these steps:
# Install the code-weather skill
openclaw install code-weather
# Navigate to your project root and generate a report
code-weather report
# View current alerts and the 5-day forecast
code-weather forecast
Code Weather Data Schema & Taxonomy
The skill organizes repository health data into a metaphorical taxonomy for quick analysis:
| Category | Metric Source | Interpretation |
|---|---|---|
| Temperature | Tests & Coverage | Overall project health and stability |
| Sky Conditions | Quality Metrics | Presence of bugs, linting errors, or flaky tests |
| Wind | Commit Velocity | Change frequency and development churn |
| Pressure | Complexity Delta | Growth or reduction of technical debt |
| Visibility | Documentation | Naming clarity and documentation coverage |
Regional weather is broken down by directory, allowing granular tracking of specific modules like src/api/ or src/ui/.
Code Weather Advanced Features
- Regional Weather Alerts: Automatically flags specific sub-modules that fall below health thresholds.
- Forecast Algorithm: Predicts future codebase stability based on 7, 14, and 30-day historical trends.
- Special Event Detection: Identifies high-risk scenarios such as an Ice Age (stalled development) or a Volcano (major rewrite eruption).
- Zero-Dependency Architecture: Operates entirely offline with no external API calls, ensuring your codebase metrics stay private within your Openclaw Skills environment.
SKILL.md
Loading
Related Openclaw Skills
Code Oracle
Code Oracle is a mystical fortune-teller for your codebase that transforms real technical metrics into engaging prophecies and tarot-style readings.
Apophenia Guard
A cognitive bias interceptor that monitors debugging reasoning to prevent developers from chasing false patterns and red herrings.
War/Den Governance
A comprehensive governance and security layer that intercepts and evaluates every AI agent action against strict safety policies before execution.
Achievement Unlocked
A gaming-style achievement system that turns your real-world coding milestones into XP, levels, and legendary trophies.
Commit Poetry
Commit Poetry is a creative tool that transforms your git history into various poetic forms based on the nature of your code changes.
Context Resume
Reconstructs your full developer mental state and task context after any interruption or time away from the keyboard.
Featured*
