iterate-to-evidence

Iterates on products through repeated observation, implementation, and verification cycles.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill iterate-to-evidence-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iterate-to-evidence
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/iterate-to-evidence
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill iterate-to-evidence-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Broad quality requests like "make it feel better" or "polish this" often end with code that is merely implemented rather than genuinely improved. This Skill turns subjective quality goals into an evidence-backed loop of observing the real product surface, making targeted changes, and re-verifying the result. ## Core Features & Use Cases - Acceptance Matrix Conversion: Translates vague terms like "good" or "polished" into concrete, testable acceptance criteria before any code changes. - Observe-Change-Verify Loop: Ranks problems by user impact, implements the smallest high-impact slice, then re-observes the actual browser, game view, or device to confirm improvement. - Review Lenses Reference: Ships a curated checklist covering visual hierarchy, game feel, product flows, and writing quality to guide systematic inspection. - Use Case: A user asks to polish a game's first-time experience. The Skill captures baseline gameplay evidence, fixes the highest-impact friction point, re-plays the opening sequence, and repeats until the acceptance criteria are met. ## Quick Start Use iterate-to-evidence to inspect my web app, improve the roughest part of the onboarding flow, and keep verifying with screenshots until it genuinely feels polished.

Frequently Asked Questions about iterate-to-evidence

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve a product when the request is vague like "make it feel better"?

Convert subjective language into a compact acceptance matrix first, then observe the real user path to build a baseline. Rank problems by user impact and fix one coherent slice at a time, re-observing after each change.

How to verify UI or gameplay improvements with evidence?

Capture screenshots, timings, logs, or interaction counts before and after each change through the ordinary user path. Inspect screenshots closely, zooming into affected areas and checking surrounding composition for regressions.

Can this approach work for games, VR, and 3D experiences?

Yes, the review lenses reference covers game-specific checks like the first 5/15/30 seconds, camera comfort, action-feedback loops, pacing, and platform fit. It applies to desktop, mobile, VR, controller, and multiplayer paths.

When should the improvement loop stop iterating?

Stop when acceptance criteria are met, the real surface was re-observed after the last change, tests pass or failures are bounded, and another iteration would be low-value or out of scope. Report remaining limitations honestly.

What are the limitations of evidence-based iteration?

If the real surface cannot be observed, only static checks are possible and unverified aspects must be stated explicitly. It also does not broaden authorization, so publishing, deploying, or deleting requires explicit user approval.