critique
Skill4 starsChanged 7 months agoMITView on GitHub
Score any pstack artifact (vision, PRD, design brief) against its rubric. Reports weighted average, per-dimension scores, specific gaps, and concrete improvement suggestions.
80 other projects use a version of this.
Adopted by
Most recently taken up by
- BSchrift/critique.nvimtheir own version, first seen Nov 8, 2026
- Integralist/agent-skillstheir own version, first seen Nov 6, 2026
- pche-broken-artist/forge-of-thoughttheir own version, first seen Nov 6, 2026
- theexperiencecompany/gaiatheir own version, first seen Nov 3, 2026
- bas1l/claude-skillstheir own version, first seen Nov 3, 2026
- synaptiai/agent-capability-standardtheir own version, first seen Nov 1, 2026
Used with
Projects with it also use delight, teach-impeccable and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
HK-hubSkilldelight
Add moments of joy, personality, and unexpected touches that make interfaces memorable and enjoyable to use. Elevates functional to delightful. Use when the user asks to add polish, personality, animations, micro-interactions, delight, or make an interface feel fun or memorable.
Also in 33 projects that use this
HK-hubSkillteach-impeccable
One-time setup that gathers design context for your project and saves it to your AI config file. Run once to establish persistent design guidelines.
Also in 19 projects that use this
zwy123zwySkillnormalize
将用户随意输入的提示词规范化为结构清晰、便于大模型执行的标准化提示词。适用于需要整理、统一提示词格式时调用。
Also in 19 projects that use this
owshq-mecSkilllayout
Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy. Use when the user mentions layout feeling off, spacing issues, visual hierarchy, crowded UI, alignment problems, or wanting better composition.
Also in 8 projects that use this
- +8 more from HK-hub
Other versions80 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 80
- google-gemini/gemini-cli★ 109ksame name
- yournextstore/yournextstore★ 5.5ksame name
- plugin87/ux-ui-agent-skills★ 3.1ksame name
- remorses/critique★ 1.3ksame name
- talesofai/cohub★ 585same name
- educlopez/ui-craft★ 441same name
- nexmoe/DayBee★ 424same name
- nexmoe/eve★ 424same name
- Southclaws/storyden★ 348same name
- 10xChengTu/Mux0★ 337same name
70 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository18 other files it gives its agents.
- bhaskar-reviewSkill
- cagan-reviewSkill
- challengeSkill
- design-briefSkill
- julie-reviewSkill
- lenny-reviewSkill
- north-starSkill
- onboardSkill
- opportunitySkill
- prdSkill
- pstack-helpSkill
- pstack-learnSkill
- pstack-statusSkill
- pstack-upgradeSkill
- ravi-reviewSkill
- shreyas-reviewSkill
- strategySkill
- visionSkill
The file
We split this skill into the rules it gives an agent
11 rules. 0 are common, 6 are distinctive, and 5 are very specific to this project.
0
Common
Most of the 73 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 16
If the user invokes /critique without specifying a file, check pstack-workspace/{slug}/ for artifacts in reverse order (newest first).
- Distinctive: line 18
If the user specifies a file, confirm it exists.
- Distinctive: line 34
Read all three calibration files silently before scoring.
- Very specific: line 42
Read the dimension's prompts — answer each prompt based on the artifact
- Very specific: line 43
Read the scale definitions (1, 3, 5)
- Distinctive: line 45
Write one sentence of evidence: what in the artifact justifies this score
- Distinctive: line 47
Do not anchor to a round number without evidence.
- Very specific: line 102
Update the artifact's rubric_score to the new score.
- Distinctive: line 110
Never give a 5 unless the artifact matches the score-5 calibration example on that dimension
- Distinctive: line 111
Never skip a dimension — every rubric dimension must appear in the output
- Very specific: line 112
If the artifact is a reviewer output (review file in reviews/), do not score it — /critique only scores generator artifacts (vision, …
“Common” is measured: kept by at least 6 in 10 of the 73 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
/critique
You are the pstack rubric scorer. You evaluate a pstack artifact against its structured rubric — consistently, with calibrated numeric scores and specific, actionable gaps.
Step 1 — Identify the artifact
If the user invokes /critique without specifying a file, check pstack-workspace/{slug}/ for artifacts in reverse order (newest first). Present: "Found: {list}. Which would you like to critique?"
If the user specifies a file, confirm it exists. If not found, tell the user.
Step 2 — Load rubric and calibration set
Based on the artifact type:
| Artifact | Rubric | Calibration files |
00-vision.md | knowledge/rubrics/vision.yaml | calibration/vision-score-2.md, calibration/vision-score-3.5.md, calibration/vision-score-5.md |
01-strategy.md | knowledge/rubrics/strategy.yaml | calibration/strategy-score-2.md, calibration/strategy-score-3.5.md, calibration/strategy-score-5.md |
opportunity-*.md | knowledge/rubrics/opportunity.yaml | calibration/opportunity-score-2.md, calibration/opportunity-score-3.5.md, calibration/opportunity-score-5.md |
02-prd.md | knowledge/rubrics/prd.yaml | calibration/prd-score-2.md, calibration/prd-score-3.5.md, calibration/prd-score-5.md |
03-design-brief.md | knowledge/rubrics/design-brief.yaml | calibration/design-brief-score-2.md, calibration/design-brief-score-3.5.md, calibration/design-brief-score-5.md |
Read all three calibration files silently before scoring. They anchor your numeric judgment — score 2 means the artifact resembles the score-2 calibration example; score 5 means it resembles the score-5 example.
Step 3 — Score each dimension
For each dimension in the rubric:
- Read the dimension's
prompts— answer each prompt based on the artifact - Read the
scaledefinitions (1, 3, 5) - Assign a score between 1 and 5 (can be non-integer: 2.5, 3.5, 4.5)
- Write one sentence of evidence: what in the artifact justifies this score
Do not anchor to a round number without evidence. The calibration set is the anchor — not your general sense of "good."
Step 4 — Compute weighted average
Formula: (sum of dimension_score × dimension_weight) / (sum of all weights)
Round to one decimal place.
Step 5 — Present the critique
Format:
## Critique: {filename}
**Weighted score: {X.X} / 5.0**
{PASSES / DOES NOT PASS the {passing_floor} floor for advancing to the next skill}
### Dimension scores
| Dimension | Score | Weight | Evidence |
|---|---|---|---|
| {name} | {score}/5 | {weight} | {one-sentence evidence} |
| {name} | {score}/5 | {weight} | {one-sentence evidence} |
| … | | | |
### Gaps to close
**{Lowest-scoring dimension} ({score}/5 — needs improvement)**
{2–3 specific, actionable suggestions for what the artifact needs to reach a 4+ on this dimension.}
**{Second-lowest dimension} ({score}/5)**
{2–3 specific suggestions.}
### What's working
{2–3 sentences about what the artifact does well — not empty praise, specific strengths.}
### Recommended next
{If score < passing_floor}: Revise the artifact focusing on {lowest-scoring dimension} before running the next generator skill.
{If score ≥ passing_floor and state is VISION_DONE}: Run `/strategy` — vision passes the quality gate.
{If score ≥ passing_floor and state is STRATEGY_DONE}: Run `/prd` — strategy passes the quality gate (or `/opportunity` to pressure-test a risky bet first).
{If score ≥ passing_floor and state is PRD_DONE}: Run `/design-brief` — PRD passes the quality gate.
{If score ≥ passing_floor and state is BRIEF_DONE}: Run `/cagan-review` or another persona review.Step 6 — Update .pstack-meta.json
Update the artifact's rubric_score to the new score. Timestamp the update.
Rules
- Scores must be calibrated against the calibration set — do not inflate or deflate without evidence
- The "Gaps to close" section must name specific lines or sections from the artifact — not generic advice
- Never give a 5 unless the artifact matches the score-5 calibration example on that dimension
- Never skip a dimension — every rubric dimension must appear in the output
- If the artifact is a reviewer output (review file in
reviews/), do not score it —/critiqueonly scores generator artifacts (vision, strategy, opportunity, PRD, design brief)
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.

