Agent skill

Refine

by windmill-labs in windmill-labs/windmill

End-of-session reflection. An agent skill from windmill-labs/windmill.

Custom licenceAuto-check passed

Install Refine

skills CLI
$ npx skills add windmill-labs/windmill --skill refine -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install windmill-labs/windmill refine --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/windmill-labs/windmill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/refine .claude/skills/refine && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
refine
GitHub stars
18k
Token cost
~420 tokens
SKILL.md length
216 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
Custom licence

At a glance

End-of-session reflection. An agent skill from windmill-labs/windmill.

  • Works in 5 steps: Identify friction: Review what happened… → Read current docs: Read the docs that… → Propose updates: For each piece of… → …
  • SKILL.md covers Instructions and Rules
  • Calls git

What it does

Refine is an agent skill from windmill-labs/windmill. End-of-session reflection. Reviews friction encountered during the session and proposes updates to docs/ to capture lessons learned.

Its SKILL.md is about 420 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Open-source developer platform to power your entire infra and turn scripts into webhooks, workflows and UIs. Fastest workflow engine (13x vs Airflow). Open-source alternative to…

Example prompts

  • “/refine”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Identify friction: Review what happened in this session
  2. Read current docs: Read the docs that were relevant to this session
  3. Propose updates: For each piece of friction, decide if it warrants a doc update
  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.

What it can do on your machine

Read from SKILL.md and the folder at commit f40eea2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Refine loads about 420 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 216 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~420

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 216 words (~420 tokens).

“Reflect on the current session and update documentation with lessons learned.”

— opening of SKILL.md by windmill-labs, Custom licence
name
refine
user_invocable
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/refine of windmill-labs/windmill.

Open the folder on GitHubat commit f40eea2

Compare with similar skills

Refine next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Refine compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Refine this skillwindmill-labs/windmill18k—~420Automated safety check: PassCustom licence
Reflection Coachpaperclipai/paperclip99k—~3kAutomated safety check: PassMIT
Reflectalirezarezvani/claude-skills28k1 repos~2.4kAutomated safety check: PassMIT
Geo Proposalsickn33/agentic-awesome-skills47k1 repos~3.2kAutomated safety check: NotesMIT
Better Proposals AutomationComposioHQ/awesome-claude-skills77k3 repos~764Automated safety check: PassNone
Agent Refinementruvnet/ruflo74k2 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Reflection Coach

    paperclipai/paperclip

    Reflect on another agent's recent execution record and propose the smallest durable instruction, skill, or tool-description change.

    99k GitHub stars~3k tokensUpdated today
    Sales & SupportAuto-check passed
  • Reflect

    alirezarezvani/claude-skills

    Mid-conversation reflection skill that pauses execution and zooms out from detail-mode to honestly reassess direction, assumptions, and bias.

    28k GitHub starsUsed in 1 repo~2.4k tokens
    Agent WorkflowsAuto-check passed
  • Geo Proposal

    sickn33/agentic-awesome-skills

    Auto-generate a professional, client-ready GEO service proposal from audit data.

    47k GitHub starsUsed in 1 repo~3.2k tokens
    Sales & SupportAuto-check: notes
  • Better Proposals Automation

    ComposioHQ/awesome-claude-skills

    Automate Better Proposals tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~764 tokens
    Productivity & AutomationAuto-check passed
  • Agent Refinement

    ruvnet/ruflo

    Agent skill for refinement - invoke with $agent-refinement. An agent skill from ruvnet/ruflo.

    74k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Contract And Proposal Writer

    alirezarezvani/claude-skills

    Generate professional, jurisdiction-aware business documents: freelance contracts, project proposals, SOWs, NDAs, and MSAs.

    28k GitHub starsUsed in 2 repos~3.4k tokens
    Legal & ComplianceAuto-check passed

More from windmill-labs/windmill

All 42 skills in this repo
  • Windmill Trigger Type Checklist

    windmill-labs/windmill

    Checklist of every backend, frontend, CLI and capture change needed to add a new TriggerCrud-based trigger type, such as Azure, GCP or Kafka, to Windmill.

    18k GitHub stars~4.7k tokensUpdated today
    Auto-check passed
  • Windmill AI Evals

    windmill-labs/windmill

    Writes and runs black-box benchmark cases for Windmill's flow, app, script, CLI and global AI generation modes, including before-and-after comparisons.

    18k GitHub stars~969 tokensUpdated today
    Auto-check: notes
  • Domain Modeling and Glossary

    windmill-labs/windmill

    Actively challenges vague or conflicting terminology as you design, and keeps a living domain glossary file up to date in real time.

    18k GitHub stars~622 tokensUpdated today
    Auto-check passed
  • Local PR Review

    windmill-labs/windmill

    Runs the same code review locally that GitHub's auto-review actions run on a PR, delegating to a fresh-context subagent so the review isn't biased by the main session's own reasoning.

    18k GitHub stars~995 tokensUpdated today
    Auto-check passed
  • Draft PR with CI Rounds

    windmill-labs/windmill

    Opens a draft GitHub pull request with a conventional title and explicit body, then drives CI review rounds before marking it ready.

    18k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Windmill Dev Page Preview

    windmill-labs/windmill

    Opens the Windmill dev page to preview a flow, script or app, choosing between proxy and direct mode and deciding whether the agent or the runtime starts the wmill dev server.

    18k GitHub stars~1.8k tokensUpdated today
    Auto-check passed

Questions about Refine

What does Refine do?

End-of-session reflection. An agent skill from windmill-labs/windmill. Refine is an agent skill from windmill-labs/windmill. End-of-session reflection.

How do I install Refine in Claude Code?

Run `npx skills add windmill-labs/windmill --skill refine -a claude-code`. Or copy the skill folder (.agents/skills/refine in windmill-labs/windmill) into .claude/skills/refine in your project. Claude Code loads it when a task matches its description.

How do I install Refine in Codex?

Run `npx skills add windmill-labs/windmill --skill refine -a codex`. Or copy the skill folder (.agents/skills/refine in windmill-labs/windmill) into .agents/skills/refine in your project. Codex loads it when a task matches its description.

Can I use Refine in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add windmill-labs/windmill --skill refine -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/refine, .gemini/skills/refine, .github/skills/refine and .opencode/skills/refine in your project.

What does Refine need to run?

Going by SKILL.md and its folder, Refine needs the command-line tools its instructions call (git).

Does Refine access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Refine safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Refine use?

Refine has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Refine use?

About 420 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Refine?

Skills that share tags, products or a category with Refine: Reflection Coach (paperclipai/paperclip, 99k stars), Reflect (alirezarezvani/claude-skills, 28k stars), Geo Proposal (sickn33/agentic-awesome-skills, 47k stars) and Better Proposals Automation (ComposioHQ/awesome-claude-skills, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Refine?

windmill-labs (a GitHub organization) maintains it in windmill-labs/windmill, which has 18,128 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on October 8, 2026.

Source: windmill-labs/windmill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.