product-quality
Skill1 starsChanged 45 days agoMITView on GitHub
Test complete user journeys against requirements, including recovery and cross-role effects. Use for test this user flow, acceptance testing, or can users complete this task. For visual or accessibility-only review prefer design-quality.
In this repository12 other files it gives its agents.
- templates/CLAUDE.mdCLAUDE.md
- code-qualitySkill
- data-integritySkill
- design-qualitySkill
- feature-deliverySkill
- growth-strategySkill
- performance-reviewSkill
- product-designSkill
- product-planningSkill
- release-engineeringSkill
- security-auditSkill
- systematic-debuggingSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Use the project test format or the journey matrix.
- Distinctive: line 18
Follow the whole journey from a realistic entry point to a verifiable outcome.
- Very specific: line 21
Use realistic content and synthetic fixtures with known outcomes.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Product quality
Evaluate whether the intended audience can complete the agreed task and obtain the correct outcome. Test from requirements, not from assumptions embedded in the implementation.
Establish the test target
Discover relevant requirements, role rules, feature changes and existing tests. Name the stage: specification, prototype, running feature or release candidate. Identify the build, environment, available accounts/data and supported devices. A prototype review cannot establish runtime or backend correctness.
Use the project test format or the journey matrix. Prioritize changed journeys, critical outcomes and plausible failure boundaries. A dedicated quality pass should look beyond the happy-path checks used during implementation.
Exercise the experience
- Follow the whole journey from a realistic entry point to a verifiable outcome. Check another actor's view or durable result when the feature crosses roles or systems.
- Cover applicable interruption, cancel/back, draft/resume, login/session expiry, missing permissions, empty data, invalid input and service failure.
- Exercise retries, double submissions, concurrent edits and delayed/reordered responses when they can change the outcome. Confirm that UI feedback matches the actual persisted result.
- Use realistic content and synthetic fixtures with known outcomes. Test the supported role/device/language combinations most exposed to the change.
- Investigate friction, ambiguous choices, misleading labels and dead ends. Record a suspected usability issue as a hypothesis unless observed with actual participants.
Run available behaviour, API, browser and device tests. Inspect reset/seed setup before using it and keep it on disposable data. Avoid real notifications, purchases or messages unless they are explicitly part of the authorized test. Creating a missing test harness is appropriate when the user requested test implementation; otherwise report that coverage gap and use available checks.
Evaluate product understanding
For requested usability evaluation, use study guidance. AI walkthroughs can find likely friction and prepare a study; they cannot supply real participant evidence. Do not invent task-completion rates, interviews, satisfaction or conversion improvements.
Report and hand off
Use the project's test format or the journey matrix. A compact report can use one row per case with case/steps, expected result, actual result/evidence, environment and status. Record PASS, FAIL, BLOCKED or NOT RUN. BLOCKED identifies a specific missing prerequisite; NOT RUN means no execution was performed. Neither establishes a product defect or a pass. Give severity with user impact for observed defects.
Audit requests return findings. If fixes are also requested, address the cause, add meaningful regression coverage and retest the journey. Feed requirement gaps into the authoritative brief. Link visual/accessibility findings to the design-quality concern without duplicating or inflating the defect list.
Summarize verified outcomes, open defects and untested areas. Do not certify an entire product from one successful flow or build.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

