validate

SkillDev tools

Run flow validate and fix any failures. Invoke after completing a feature or bug fix to confirm the codebase is clean before committing.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the validate skill

What this skill tells your AI

The instructions your AI receives, as published by flowexec/flow in .claude/skills/validate/SKILL.md and read by ahel’s review.

Run the validate executable via mcp__flow__execute (ref: validate) rather than a raw shell call, so the run inherits workspace env/secrets and is captured in flow's history.

It runs these steps in order: generatelinttestvalidate generated (checks for uncommitted generated diffs in CI).

For each failure, diagnose and fix before moving on:

  • generate fails: Schema syntax error in the source schema — types/executable/*_schema.yaml, or types/{config,workspace,common}/schema.yaml. Read and fix the schema, never the .gen.go output.
  • lint fails: Read the golangci-lint output, fix each violation, re-run
  • test fails: Read the Ginkgo output, identify the failing spec, fix the root cause — do not skip or comment out tests
  • validate generated fails: Generated files are out of sync — re-run the generate executable and stage the regenerated files; this is always the fix

Use mcp__flow__get_execution_logs with mine: true to re-read output from a run instead of re-running it.

Do not report done until validate exits 0 with all steps passing.

Signals

GitHub stars
136
Forks
4
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
validate-flowexec
Source
github.com/flowexec/flow