gf-evolve

Patch GuanFu skills using RED evidence and minimal testable cycles.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/Sailfishc/guanfu --skill gf-evolve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gf-evolve
Source: https://github.com/Sailfishc/guanfu/tree/main/skills/gf-evolve
Command: npx skills add https://github.com/Sailfishc/guanfu --skill gf-evolve

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Enables systematic improvement of GuanFu by turning user feedback, failures, and drift into structured, traceable skill evolutions.

Core Features & Use Cases

  • Minimal patch cycles: patch the smallest surface affected (skill, template, script) to close a failure.
  • RED-gate driven validation: requires RED evidence before applying changes and tracks progress through the evolution lifecycle.
  • Documentation and templates refresh: updates CHANGELOG, VALIDATION, and package docs to reflect changes and prevent drift.

Quick Start

Observe a failure, collect RED evidence, and implement a minimal evolution patch that updates the relevant skill and its validation artifacts; then revalidate.

Frequently Asked Questions about gf-evolve

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

FAQPage Schema
How do I improve a skill after observing repeated failures and drift?

You need RED evidence before applying changes to improve a skill from failures. By requiring RED evidence first, the evolution process enforces validation and tracks progress through the lifecycle, ensuring that patches close actual gaps rather than masking symptoms.

What is the best way to structure skill evolution patches from user feedback?

The best way to structure skill evolution patches from user feedback is to apply minimal patch cycles. Observe a failure, collect RED evidence, and implement a minimal evolution patch that updates the relevant skill and its validation artifacts, then revalidate to confirm the fix.

When do I need to update validation and packaging docs for a skill?

You need to update validation and packaging docs for a skill when applying an evolution patch to prevent drift. Refreshing CHANGELOG, VALIDATION, and package docs ensures that the documentation accurately reflects the applied changes and maintains traceability.

Does this skill evolution process require dependencies to apply patches?

No, this skill evolution process requires no external dependencies to apply patches. It operates by adjusting pressure scenarios and updating RED evidence internally, allowing you to guide minimal patch cycles and revalidate without needing additional tools.

Why does skill drift occur and how can I prevent it during patch cycles?

Skill drift occurs when validation gaps and repeated failures remain unaddressed during updates. You can prevent it by using RED-gate driven validation to require RED evidence before applying changes, and by refreshing documentation to ensure patches are traceable.