Skip to content
GBTI
Sign in

/QA : An Agent Skill for Resolving Open Questions

Hudson Atwell

A drop-in `/qa` skill for Claude Code that collects the questions your agent just raised and asks them in a single batch, in plan mode, before any code is written. By default, it reviews only the last reply to keep usage low; `/qa deep` runs the full six-category review when needed.

Claude Code loads any markdown file at .claude/skills/<name>/SKILL.md as a reusable slash command (a “skill”). This one gives your agent a /qa command that stops before it builds, pulls every unresolved decision into a single batch of questions, and refuses to write code until you have answered them.

It exists because open questions have a habit of surfacing at the wrong end of the work. A sprint finishes, and only then does the agent raise the decisions it should have raised at the start, at exactly the point where acting on them means redoing something.

The mechanism is plan mode, invoked deliberately. The agent puts ITSELF into a read-only state, does its research there, asks everything it found as a form you click through, and only then acts. That ordering is the whole feature.

Install

  1. Create .claude/skills/qa/ in your repo, or ~/.claude/skills/qa/ to have it in every project.
  2. Save the file below as SKILL.md inside it.
  3. Type /qa in Claude Code.

Nothing to configure. The skill reads your project, not a config file.

Prompt

Members-only content

This content is for members. Become a member and it unlocks here, or if you already are.

You are signed in. Unlocking this content now.

A creator network, powered by Git

Join the GBTI Network

The GBTI Network is a creator community. Browse, follow, and save across the network for free, no card required. Join a paid tier to take part and share in the revenue.

Network Member ($50/year): post comments across the network; full Discord access; read members-only content and comment bodies; and see the member-only Shares stream. Earn 10% for life on the paid revenue of members you invite.
Curator ($150/year): everything in Network Member, plus publish articles, products, and prompts; post to the member Shares stream; your creator profile and unified portfolio; and reshare and syndicate your work. Curators share in the revenue program.
Become a member You are reading atwellpub's work. Joining from this page credits atwellpub.

Get the weekly digest

One email a week: new member articles, projects and prompts, plus the developer news worth reading. Unsubscribe in one click, any time.

We send a confirmation email first. You are not subscribed until you click the link in it. Read the privacy policy.

From the author

atwellpub

I wrote this because my work sprints kept ending the same way: with raised questions. The work would wrap up, and only then would the open decisions surface, at the point where acting on them meant redoing something.

So I gave myself a way to invoke the pass I wanted, on demand. Typing /qa gets the questions asked, in plan mode, before anything is written. /qa continue does the same and then just builds once I have answered.

I keep the default narrow on purpose. It reads only what the agent just told me and asks about that, because that is the case I actually hit, and a full sweep of the repository on every invocation is more tokens than the job is worth. /qa deep is there for when I do want the wide pass.

The rest of the file exists to keep the questions worth answering: audit the repository first so it never asks what the code already says, and say plainly when there is nothing left to decide rather than inventing something to ask.

0 Comments

No comments yet. Be the first. Members comment from the GBTI local client, where comments are submitted as pull requests and auto-published for paid members.

Become a member

Comments are for members. Become a member to join the conversation, or if you already are.

You are signed in as a member. .

Join the GBTI co-op

Saving, collecting, and following are member perks. Sign in with a free GitHub account to keep what you find, and become a member to comment, join the Discord, and unlock members-only content.