Agent QA Knowledge

Use when asked what an agent-qa run did, why a step passed or failed, what a run's screenshots, console or network showed, what knowledge agent-qa learned or served, where a knowledge record came from, or which runs exist. Reads runs, evidence and knowledge through the agent-qa MCP tools or the agent-qa CLI with --json, never through .agent-qa files, SQLite or index files.

862 stars 26 forksTesting & QA

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add vostride/agent-qa --skill agent-qa-knowledge
Manual install
git clone --depth 1 https://github.com/vostride/agent-qa.git /tmp/agent-qa
mkdir -p ~/.claude/skills
cp -r /tmp/agent-qa/packages/cli/skills/agent-qa-knowledge ~/.claude/skills/agent-qa-knowledge

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# agent-qa Knowledge

Get the whole picture first, then fetch only the piece the question needs.

## Workflow

1. Find the run with `agent_qa_list_runs`: completed runs, newest first, each naming its tests.
   Narrow it with `verdict`, `test`, `target`, `since` or `limit` when the question does.
2. Map it with `agent_qa_get_run_overview` and `{ "runId": "<runId>" }`. It lists every test and
   step with its verdict, screenshot shas, evidence kinds with counts, served records, whether a
   brief trace exists, and what the run learned. It carries addresses, not bodies.
3. Fetch only what the question needs, using the overview's addresses:
   - one step's document: `agent_qa_get_run_evidence` with `"action": "runs.evidence"`, `runId`,
     `testIndex`, `stepIndex` and `kind` (`console`, `network`, `a11y`, `aria` or `variables`;
     `subActionIndex` with `aria` only);
   - a screenshot: `agent_qa_get_run_evidence` with `"action": "runs.artifact"`, `runId` and
     `sha`. The answer is an image you can look at;
   - a record or a brief: the table below.
4. Answer with provenance: the run id, test and step numbers, and record ids you relied on.
   When a read says absent, withheld, not recorded or read error, say so and what it limits.

Test, step and sub-action numbers are zero-based, exactly as the overview prints them. Without
MCP, run the CLI verb from the project root. `--json` prints what the tool answers, except that
Read the full skill on GitHub

Details

Skill name
agent-qa-knowledge
Path
packages/cli/skills/agent-qa-knowledge/SKILL.md
Repo updated
14 November 2026

FAQ

What does the Agent QA Knowledge skill do?

Use when asked what an agent-qa run did, why a step passed or failed, what a run's screenshots, console or network showed, what knowledge agent-qa learned or served, where a knowledge record came from, or which runs exist. Reads runs, evidence and knowledge through the agent-qa MCP tools or the agent-qa CLI with --json, never through .agent-qa files, SQLite or index files.

How do I install the Agent QA Knowledge skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add vostride/agent-qa --skill agent-qa-knowledge. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Agent QA Knowledge popular?

It lives in vostride/agent-qa, which has 862 GitHub stars and 26 forks, and is included in 2 curated skill lists.

Related skills

Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.