qa-report — Claude Code skill: QA planning and installation
This skill maintains project QA docs, maps user journeys, and plans persona-led sessions. Use it to keep planning and bug records connected across QA cycles.
npx skills add pedronauck/skills --skill qa-report -a claude-codeWhat qa-report does
qa-report keeps durable QA documentation in the repository, using docs/qa/ by default. It maps user journeys as Mermaid flows, derives scenarios from those maps, and prepares session charters for personas. Scenarios remain untested until qa-execution runs them.
The skill also checks for an existing bug with the same symptom before adding a registry entry, then links the bug to affected scenarios. For a new or full cycle, it checks the planning tree; a targeted update can focus on affected entries. This skill plans sessions. qa-execution runs them and records evidence.
Pass [qa-docs-path] to choose a different location; otherwise, the tree goes under docs/qa at the repository root. It should be a durable repository location, not a temporary directory. To install in Claude Code, run npx skills add pedronauck/skills --skill qa-report -a claude-code.
What it helps with
- map a user journey with a Mermaid flow and an abandonment path
- derive linked QA scenarios from a journey map
- prepare persona-based session charters
- find a duplicate symptom and update its bug record
- check planning coverage for a QA cycle
Example prompts for the agent
- Plan QA for the profile changes: update the journey map, scenarios, and session charters in
docs/qa. - Add a persona for the checkout journey and prepare a session with one tour.
- Search
docs/qa/bugsfor this symptom and update its existing record if it is already tracked.
How to install qa-report
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill qa-report -a claude-code2Manually: put the files in place
~/.claude/skills/qa-report/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/qa-report/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill qa-report -a codex2Manually: put the files in place
.agents/skills/qa-report/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill qa-report -a cursor2Manually: put the files in place
.cursor/skills/qa-report/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills qa-report2Manually: put the files in place
.github/skills/qa-report/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill qa-report -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/mine/qa-reportManually: put the files in place
.devin/skills/qa-report/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill qa-report -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about qa-report
How do I install qa-report in Claude Code?
Run npx skills add pedronauck/skills --skill qa-report -a claude-code. The skill file is at ~/.claude/skills/qa-report/SKILL.md.
What does qa-report do?
It maintains project QA docs, journey maps, scenarios, persona session charters, and the bug registry. qa-execution runs the planned sessions.
Where does qa-report store its QA documentation?
By default, it uses docs/qa at the repository root. Pass [qa-docs-path] to choose another durable location in the repository.
