Skip to main content

refine

End-of-session reflection. Reviews friction encountered during the session and proposes updates to docs/ to capture lessons learned.

Source facts

Repository
windmill-labs/windmill
Last source activity
August 13, 2026 at 11:12
Detected SKILL.md language
English
Stars
18,107
Forks
1,111

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
refine
user_invocable
true
description
End-of-session reflection. Reviews friction encountered during the session and proposes updates to docs/ to capture lessons learned.
# Refine Skill Reflect on the current session and update documentation with lessons learned. ## Instructions 1. **Identify friction**: Review what happened in this session: - Run `git diff main...HEAD --stat` to see what files were touched - Think about: what was slow, what failed, what required multiple attempts, what information was missing or hard to find 2. **Read current docs**: Read the docs that were relevant to this session: - `docs/validation.md` - `docs/enterprise.md` - Any skills that were invoked 3. **Propose updates**: For each piece of friction, decide if it warrants a doc update: - **Missing knowledge**: Information you had to discover that should be documented - **Wrong guidance**: Instructions that led you astray - **Missing validation rule**: A check that should be in the validation matrix - **New pattern**: A codebase pattern worth capturing for next time 4. **Apply updates**: Edit the relevant `docs/` files. Keep changes minimal and specific — add only what would have saved time this session. 5. **Report**: Summarize what was added/changed and why. ## Rules - Only add knowledge confirmed by this session — no speculative additions - Keep docs concise — add a line or two, not a paragraph - If a whole new doc is needed, create it in `docs/` and add a pointer in `CLAUDE.md` - Don't update skills unless a coding pattern was genuinely wrong - Don't add things Claude already knows — only Windmill-specific knowledge
View on GitHub