evolution

Track file change history across git commits and summarize evolution.

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/supertyrelle/pelley --skill evolution-supertyrelle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evolution
Source: https://github.com/supertyrelle/pelley/tree/main/skills/evolution
Command: npx skills add https://github.com/supertyrelle/pelley --skill evolution-supertyrelle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you understand how a definition file changed over time, why it looks the way it does, and whether it is stable enough to modify safely.

Core Features & Use Cases

  • Tracks creation, last modification, total churn, and edit frequency for a specific file.
  • Detects rushed fix-after-feat sequences and summarizes recent growth, shrinkage, or stability.
  • Useful for reviewing skills, agents, and rules before refactoring or investigating quality issues.

Quick Start

Ask the evolution skill to analyze skills/evolution/SKILL.md and report its history, stability, and any fix-after-feat patterns.

Frequently Asked Questions about evolution

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

FAQPage Schema
How do I track a file's git history and assess its change stability?

To track a file's git history and assess change stability, this Skill analyzes git log commits to report creation dates, last modifications, edit frequency, and line deltas. It summarizes trends to show whether a file is stable or experiencing rapid churn.

Can I detect fix-after-feat patterns in git commit history for a specific file?

Yes, you can detect rushed fix-after-feat sequences in git commit history. The Skill applies deterministic heuristics to git log data to identify these patterns, helping you investigate quality issues before refactoring definition files.

What is git churn analysis and when do I need it for definition files?

Git churn analysis measures how frequently a file changes over time. You need it for definition files like skills, agents, and rules to understand recent growth or shrinkage, evaluate stability, and decide if a file is safe to modify.

Does the evolution skill work with specific git commit ranges for timeline analysis?

Yes, the evolution skill works with optional git commit ranges for timeline analysis. It uses git log history and deterministic heuristics within those ranges to report edit frequency, line deltas, and overall trend for the target file.

What's the best way to see how a definition file evolved over time before refactoring?

The best way to see how a definition file evolved is to analyze its git log history. This Skill tracks total churn, edit frequency, and fix-after-feat patterns, summarizing recent stability to help you review quality before refactoring.

Are there limitations to using git log heuristics for assessing file stability?

Limitations of using git log heuristics for file stability include relying on deterministic rules rather than semantic context. It reports line deltas and edit frequency accurately, but cannot assess the logical correctness of the changes made.