Skip to content

Instantly share code, notes, and snippets.

@maxim-saplin
maxim-saplin / README.md
Created March 6, 2026 05:48
Software QA Agent and Handoff Skill (tested in Cursor)

Cursor compatible flow (agent def + skill) that implementes QA verification by a subagent. The instructions are small and generic, should fit any product/codebase. Tested extensively with Python codebase.

Put inside right folders: .cursor/agents/qa.md .cursor/skills/qa-handoff/SKILL.md

LLM agents tend to report back to user to early. The workflow introduces an explicit requimenet to do a series of PASS/FAIL verifications by a seaparate agent before reporting back to user (a mac of 3 verfications before failing).

Works best with plan mode > plan somee work, create a new agent from the plan, right after the plan type /qa-handoff and you are good to go - the agent will create a subagent to do the verification when it considers job is done. My use of this skill shows that typically there's 1-2 rework iterations after QA subagent provide it's eval.