Commit Poetry is a creative tool that transforms your git history into various poetic forms based on the nature of your code changes.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install commit-poetry
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 commit-poetry 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 Commit Poetry?
Commit Poetry is an innovative utility designed to turn the technical chronicle of software development into genuine literary art. By interpreting git logs, branch names, and merge history, it intelligently selects poetic forms that match the intensity and scope of the work performed. Using Openclaw Skills like this one allows developers to celebrate milestones with sonnets or find humor in bugs through limericks. It provides a unique way to review project history, making the evolution of a codebase both shareable and culturally resonant within a team.
This skill is particularly effective for teams looking to inject personality into their retrospectives or documentation. It requires zero external API calls, ensuring all processing happens locally and securely within your repository environment. By leveraging Openclaw Skills, you can transform a simple git log into a narrative experience that highlights the human element behind every line of code.
Commit Poetry Use Cases
- Creating engaging sprint retrospectives that use sonnets to summarize bi-weekly achievements.
- Enhancing team morale by generating humorous limericks for small bug fixes on Friday afternoons.
- Documenting production incidents through free verse to capture the timeline and emotion of the event.
- Writing memorable release notes as rap verses or ballads for major version milestones.
- Gaining catharsis by generating gothic horror stories for legacy modules that no one wants to touch.
How Commit Poetry Works
- The skill accesses the local git repository to extract commit messages and metadata.
- It categorizes the activity based on commit length, keywords, and branch relationships.
- The engine maps the categorized work to a specific poetic mode, such as Haiku for small fixes or Ballads for migrations.
- It generates the literary output using the extracted context to ensure accuracy to the original dev work.
- The finalized poetry is presented in the terminal or exported for use in team communications.
Commit Poetry Setup
To install this skill, use the standard command for Openclaw Skills in your terminal:
# Install the skill to your local environment
openclaw add commit-poetry
# Run the skill to generate poetry for the last 5 commits
commit-poetry --last 5
# Generate a sonnet for your current sprint
commit-poetry --mode sprint
Commit Poetry Data Schema & Taxonomy
The skill organizes git data into a thematic mapping system as follows:
| Commit Type | Poetic Format | Trigger/Scenario |
|---|---|---|
| Small Bug Fix | Haiku | Single line changes or fix keywords |
| Sprint Completion | Sonnet | Milestone tags or 2-week history |
| Legacy Code | Gothic Horror | Files with long periods of inactivity |
| Major Migration | Ballad | Large diffs across many files |
| Incident Fixes | Free Verse | Sequential commits during off-hours |
| Merge Conflict | Dramatic Dialogue | Conflicting changes in a single file |
Commit Poetry Advanced Features
- Zero-dependency architecture ensuring it works offline without any external API calls.
- Context-aware mapping that identifies hotfixes and rewrites to apply the correct literary tone.
- Multi-platform support for macOS, Linux, and Windows systems.
- Specialized Incident Mode for creating expressive timelines of production outages.
- Random Limerick generation for quick, entertaining insights into any specific commit hash.
SKILL.md
Loading
Related Openclaw Skills
Code Weather
A diagnostic utility that translates technical codebase metrics like test coverage and complexity into an intuitive, metaphor-driven weather forecast.
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.
Context Resume
Reconstructs your full developer mental state and task context after any interruption or time away from the keyboard.
Dependency Autopsy
A comprehensive health examination tool for your dependency tree that evaluates risk beyond simple version checks.
Featured*
