Skip to content
cccskills
FreePublished on GitHub

refine

Review a work session to identify slow steps, failures, missing information, and useful patterns. Then make concise, evidence-based updates to relevant documentation so confirmed lessons can help with future sessions.

OriginalShow the original description

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

windmill-labs/windmill18,281 stars(GitHub 18,281 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Recording a confirmed codebase pattern in project docs
  • Adding a missing validation check discovered during a session
  • Correcting documentation that led to a failed or repeated step

Files included (1)

  • SKILL.md1.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

adding-a-trigger

FreeSummary

Plan the code changes needed to add a TriggerCrud-based trigger to Windmill. The checklist covers backend, database, API, CLI, frontend, capture, and validation work so the new trigger can be managed across the product.

  • Add a Kafka, GCP, or Azure style trigger to Windmill
  • Find all product areas affected by a new trigger kind
  • Review implementation and validation steps before a trigger PR
windmill-labs/windmill18.3KUpdated Oct 26, 2026

ai-chat

FreeSummary

Improve Windmill’s AI chat by reviewing its tools, prompts, result shapes, and context usage. The guidance helps place shared instructions where chat and CLI can use them, reduce repeated token costs, and compare behavior before and after changes with A/B evaluations.

  • Edit Windmill chat tools or system prompts
  • Reduce chat context window usage
  • Benchmark a chat behavior change
windmill-labs/windmill18.3KUpdated Oct 26, 2026

ai-evals

FreeSummary

Create and run black-box benchmarks for Windmill AI generation modes such as flows, apps, scripts, CLI, and global requests. Each case exercises the production path, checks hard requirements, and uses an LLM judge to assess user-facing behavior before and after changes.

  • Adding a benchmark case for an AI mode
  • Comparing AI chat behavior before and after a change
  • Checking copilot changes with realistic requests
windmill-labs/windmill18.3KUpdated Oct 26, 2026

cli-commands

FreeSummary

Use this reference to work with Windmill resources from the command line, including scripts, flows, datatables, and workspace settings. It also covers listing jobs, inspecting details and logs, retrieving results, and rerunning or restarting executions when investigating failures.

  • Inspecting a failed job and its logs
  • Reviewing recent runs and retrieving job results
  • Managing scripts and flows from the command line
windmill-labs/windmill18.3KUpdated Oct 26, 2026

codebase-design

FreeSummary

Use this skill to shape modules with small interfaces and substantial behavior behind them. It helps you decide where a seam belongs, reduce complexity exposed to callers, and make code easier to test and maintain.

  • Designing a module interface
  • Finding places to simplify a module
  • Choosing where behavior should vary
windmill-labs/windmill18.3KUpdated Oct 26, 2026

commit

FreeSummary

Use this skill to review pending changes, select only the relevant files for staging, and create a focused Git commit. It formats the single-line message with a Conventional Commits type such as feat, fix, or docs, and checks the resulting status.

  • Committing a new feature
  • Recording a bug fix
  • Committing documentation changes
windmill-labs/windmill18.3KUpdated Oct 26, 2026

See all skills by windmill-labs

Report a problem with this skill