agentleFS
sparkline-venturessparkline-ventures/product-eval/skills/critique/SKILL.md

critique

Skill15 starsChanged 5 months agoMITView on GitHub

Use when someone wants existing thinking attacked, graded, or handed to fresh eyes, not written or summarized. The point is to break the artifact, not produce it. It owns three intents: a skeptical outside read of conclusions, findings, themes, a synthesis, a brief, or a FAQ, from someone who was not in the room; running those findings past hostile lenses (a wary customer, CFO, engineer, competitor) to see where they collapse; and grading a problem statement or one-liner (right altitude, names a real persona, or vague mush) with a score and what is missing. Reach for it on 'give this a fresh adversarial read', 'put this in front of a skeptical X', 'score how crisp this problem statement is', 'poke holes', 'red-team this'. Do not use it to create or restate the artifact. Attacking a whole plan, roadmap, or PRD routes through pressure-test; this skill owns findings, syntheses, problem statements, and panels.

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

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 73 edited versions we read keep these.

  • 0

    Distinctive

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

    Run at any stage handoff (evidence → themes → problem → score → plan).

    line 20

“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

Run an independent adversarial review of an artifact, evidence, a theme, a problem one-liner, a score, a brief, or a FAQ. The entire value is independence: critique never grades work it produced, and never argues to agreement. Run it as a fresh pass (a subagent with its own context; a different model where available).

Independence (mandatory, read first)

Run as a separate pass with its own context, ideally a different model, so the agent that produced a finding never grades it. A critic sharing the author's context tends to rubber-stamp, which defeats the purpose. Treat the author's reasoning as something to attack, not a position to defend. State in the output that it ran independently.

Mechanism: spawn each critic/lens pass as a Task-tool subagent (a general-purpose agent) whose context contains only the artifact under review plus the relevant rubric, not the author's reasoning chain. For high-stakes reviews, prefer a different model. The bounded panel rounds are driven by the parent: collect each subagent's findings, let the author revise, then re-spawn fresh subagents for the next round.

Three modes, pick by what's under review

1. Transition critic (default, lightweight)

Run at any stage handoff (evidence → themes → problem → score → plan). Apply the relevant checks in ../pressure-test/references/critic-checklist.md plus the always-on cross-stage consistency checks. Return blocking issues (with fixes), suggestions, strengths, and overall readiness (ready / needs fixes / not ready). Every flag must be actionable.

2. Crispness grader (for a problem one-liner)

Score the problem statement on the dimensions in references/crispness-rubric.md (0-10 each), total it, and block on any dimension scoring 0. Return the lowest-scoring dimensions and a one-line rewrite that lifts them. Scale the bar to the stage, an exploratory founder one-liner needs altitude and a named persona, not yet a measured consequence. Flag, don't tyrannize.

3. Multi-lens panel (heavy; for a brief, a FAQ, or a high-stakes finding)

Convene the lenses in references/lenses.md, skeptical customer, competitor, economics/CFO, feasibility/engineer, contrarian, security/legal (only where relevant). Each lens attacks the answers or findings it owns. Run bounded rounds (max 3); stop early when a round raises no new substantive issue. Terminate every point into one of three states, never "consensus":

  • Resolved: answered and backed by evidence that clears the gate.
  • Open: needs data the panel lacks → emit a specific gap question (with where to look) routed to gather-evidence. Do not argue it closed.
  • Contested: a genuine unresolved disagreement → log it as a recorded risk for the human to weigh.

Calibration

The critic flags; it does not block everything. Match severity to stage: early discovery tolerates thin evidence (flag as a gap); a commit decision does not. An over-eager critic that demands strength-5 proof from a day-one idea is miscalibrated.

Relationship to pressure-test

pressure-test is the entry point for attacking a whole existing artifact (a plan/roadmap/PRD/bet), it runs this engine. critique is the general form, usable at any transition, for crispness, or as the panel. One adversarial engine; pressure-test is its plan-level door.

Record

Append findings, the crispness score, and any open/contested items to the investigation's decisions-log.md. Critique informs; it does not silently edit the artifact.

Output

Lead with the verdict. Modes 1-2: blocking / suggestions / strengths / readiness (plus the crispness score and rewrite). Mode 3: each point tagged resolved / open / contested, lead with the count in each state, open items carrying their gap question, contested items carrying the dissent. End with Next move: and recommend revising the artifact, gathering the named missing evidence, or pressure-testing it if it is a plan/roadmap/PRD.

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.