Use when a built product needs scoring across conversion, revenue, UX, performance, accessibility, completeness, and code quality. Chains existing audit skills into a composite 0-100 score with AI-simulated user journeys.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Use when a built product needs scoring across conversion, revenue, UX, performance, accessibility, completeness, and code quality. Chains existing audit skills into a composite 0-100 score with AI-simulated user journeys.
Evaluate Product
Chain existing audit skills and AI-simulated user journeys into a composite product score (0-100). Produces structured JSON for machine consumption and a human-readable markdown report.
This is the entry point for the evolution loop. Run after a product is built (or after a previous optimization is deployed) to establish the current baseline and identify weak areas.
Instructions
CRITICAL — NON-INTERACTIVE: Execute all steps without pausing. Never ask questions, request confirmation, or wait for input. Read state, evaluate, score, write output, update state, stop.
Step 0: Initialize
Check if factory/evolution-state.json exists:
If it exists, read it. Set CYCLE to current_cycle. Update status to "evaluating". Write back.
If it doesn't exist, create the factory/ directory structure:
Good pricing page, some upsell paths, decent retention
3
Basic pricing exists, few upsell opportunities, some churn risks
2
Pricing unclear or missing, no upsell paths, significant churn risks
1
No monetization, no pricing, no clear path to revenue
1C: User Value Critique
Apply the /critique-value rubric — score 5 dimensions (1-5): Value Delivered, Usability, Design Quality, Completeness, Accessibility. Record the average.
{"version":1,"timestamp":"[ISO-8601]","cycle":0,"project":"[project-name]","scores":{"conversion":{"score":15,"max":25,"breakdown":{"page_structure":3,"copy_effectiveness":3,"trust_credibility":2,"friction_level":4,"mobile_conversion":3}},"revenue_paths":{"score":3,"max":5,"breakdown":{"pricing_page":3,"upsell_paths":2,"churn_risk":3,"monetization_surface":4}},"ux":{"score":3.5,"max":5,"breakdown":{"value_delivered":4,"usability":3,"design_quality":3,"completeness":4,"accessibility":3}},"performance":{"score":4,"max":5,"blocking":0,"warnings":2,"optimizations":1},"accessibility":{"score":3,"max":5,"critical":0,"high":3,"medium":2},"completeness":{"score":4,"max":5,"features_complete":8,"features_partial":3,"features_missing":2},"code_quality":{"score":4,"max":5,"blocking":0,"warnings":4}},"composite_score":68,"composite_max":100,"user_journeys":[{"persona":"New visitor landing on homepage","goal":"Understand product and sign up","steps":[{"action":"Lands on homepage","page":"src/app/page.tsx","assessment":"...","friction":"low"},{"action":"Reads value prop","page":"src/app/page.tsx","assessment":"...","friction":"medium"},{"action":"Clicks CTA","page":"src/app/page.tsx","assessment":"...","friction":"low"},{"action":"Fills signup form","page":"src/app/signup/page.tsx","assessment":"...","friction":"high"}],"journey_score":3,"drop_off_point":"signup form — too many fields","recommendation":"Reduce signup to email-only, collect details later"}],"top_issues":[{"id":"issue-1","category":"conversion","subcategory":"trust_credibility","description":"No social proof above the fold","impact":"high","current_score_contribution":-2,"estimated_lift":"+10-15% conversion","source":"conversion-audit"}]}
When enabled: true, this skill will attempt to fetch real metrics and blend them with AI scores using the specified weights. Manually adjust ai_weight and real_weight as real traffic accumulates.
Error Recovery
Scenario
Recovery
Can't read source files
Score dimensions you can assess, note gaps in report
No CLAUDE.md
Use directory name as project name, skip persona customization