agentleFS
BhaskarManamBhaskarManam/pstack/skills/critique/SKILL.md

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

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-hubSkill

    delight

    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-hubSkill

    teach-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

  • zwy123zwySkill

    normalize

    将用户随意输入的提示词规范化为结构清晰、便于大模型执行的标准化提示词。适用于需要整理、统一提示词格式时调用。

    Also in 19 projects that use this

  • owshq-mecSkill

    layout

    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

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
  1. Very specific:

    If the user invokes /critique without specifying a file, check pstack-workspace/{slug}/ for artifacts in reverse order (newest first).

    line 16
  2. Distinctive:

    If the user specifies a file, confirm it exists.

    line 18
  3. Distinctive:

    Read all three calibration files silently before scoring.

    line 34
  4. Very specific:

    Read the dimension's prompts — answer each prompt based on the artifact

    line 42
  5. Very specific:

    Read the scale definitions (1, 3, 5)

    line 43
  6. Distinctive:

    Write one sentence of evidence: what in the artifact justifies this score

    line 45
  7. Distinctive:

    Do not anchor to a round number without evidence.

    line 47
  8. Very specific:

    Update the artifact's rubric_score to the new score.

    line 102
  9. Distinctive:

    Never give a 5 unless the artifact matches the score-5 calibration example on that dimension

    line 110
  10. Distinctive:

    Never skip a dimension — every rubric dimension must appear in the output

    line 111
  11. Very specific:

    If the artifact is a reviewer output (review file in reviews/), do not score it — /critique only scores generator artifacts (vision, …

    line 112

“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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

/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:

ArtifactRubricCalibration files
00-vision.mdknowledge/rubrics/vision.yamlcalibration/vision-score-2.md, calibration/vision-score-3.5.md, calibration/vision-score-5.md
01-strategy.mdknowledge/rubrics/strategy.yamlcalibration/strategy-score-2.md, calibration/strategy-score-3.5.md, calibration/strategy-score-5.md
opportunity-*.mdknowledge/rubrics/opportunity.yamlcalibration/opportunity-score-2.md, calibration/opportunity-score-3.5.md, calibration/opportunity-score-5.md
02-prd.mdknowledge/rubrics/prd.yamlcalibration/prd-score-2.md, calibration/prd-score-3.5.md, calibration/prd-score-5.md
03-design-brief.mdknowledge/rubrics/design-brief.yamlcalibration/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:

  1. Read the dimension's prompts — answer each prompt based on the artifact
  2. Read the scale definitions (1, 3, 5)
  3. Assign a score between 1 and 5 (can be non-integer: 2.5, 3.5, 4.5)
  4. 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 — /critique only scores generator artifacts (vision, strategy, opportunity, PRD, design brief)

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.