Refine
ProductivityrefineRefine is an Agent Skill for productivity published in the windmill-labs/windmill repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
End-of-session reflection. Reviews friction encountered during the session and proposes updates to docs/ to capture lessons learned.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/windmill-labs/windmill/blob/HEAD/.agents/skills/refine/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/refine, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Refine Skill
Reflect on the current session and update documentation with lessons learned.
Instructions
-
Identify friction: Review what happened in this session:
- Run
git diff main...HEAD --statto see what files were touched - Think about: what was slow, what failed, what required multiple attempts, what information was missing or hard to find
- Run
-
Read current docs: Read the docs that were relevant to this session:
docs/validation.mddocs/enterprise.mddocs/autonomous-mode.md- Any skills that were invoked
-
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
-
Apply updates: Edit the relevant
docs/files. Keep changes minimal and specific — add only what would have saved time this session. -
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 inCLAUDE.md - Don't update skills unless a coding pattern was genuinely wrong
- Don't add things Claude already knows — only Windmill-specific knowledge