refine

Reviews session friction and updates documentation with lessons learned.

Updated May 28, 2026
One-click install
npx skills add https://github.com/kma-core/windmill --skill refine-kma-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine
Source: https://github.com/kma-core/windmill/tree/main/.agents/skills/refine
Command: npx skills add https://github.com/kma-core/windmill --skill refine-kma-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Valuable knowledge discovered during a coding session is often lost when the session ends. This Skill captures friction points, missing information, and wrong guidance encountered during work, then converts them into concrete documentation updates so future sessions avoid the same problems. ## Core Features & Use Cases - Friction Identification: Reviews the session via git diff main...HEAD --stat and reflection on what was slow, failed, or hard to find. - Targeted Doc Updates: Reads relevant docs (validation.md, enterprise.md, autonomous-mode.md) and proposes minimal, specific edits. - Guardrails: Only adds session-confirmed knowledge, keeps additions concise, and avoids speculative or generic content. - Use Case: After a long debugging session where a validation rule was missing, run this Skill to add that rule to the validation matrix so the next session catches it immediately. ## Quick Start Ask the assistant to run the refine skill to review this session and update the docs with lessons learned.

Frequently Asked Questions about refine

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

FAQPage Schema
How do I capture lessons learned from a coding session?

Run the refine skill at the end of a session. It inspects what files changed with git diff, reflects on friction points like failures or missing information, and edits the relevant docs files with concise, confirmed updates.

How to keep project documentation up to date automatically?

Use an end-of-session reflection workflow that reviews what went wrong during work and updates docs accordingly. The refine skill reads existing docs, identifies missing knowledge or wrong guidance, and applies minimal targeted edits.

What kinds of documentation updates does the refine skill make?

It adds missing knowledge discovered during the session, corrects wrong guidance, adds missing validation rules, and captures new codebase patterns. It only adds knowledge confirmed by the session and keeps changes to a line or two.

When should I not use session-based doc refinement?

Avoid it when the session produced no confirmed new knowledge, since the skill explicitly rejects speculative additions. It is also not suited for large documentation rewrites, as it is designed for minimal, incremental updates.

Does the refine skill modify other skills or create new docs?

It avoids updating skills unless a coding pattern was genuinely wrong. If a whole new document is warranted, it creates it in the docs directory and adds a pointer in CLAUDE.md.