agentleFS
zjunlpzjunlp/Mechanist/skills/impact-check/SKILL.md

impact-check

Skill75 starsChanged 4 months agoMITView on GitHub

Assess whether the research problem/behavior is important — its potential value and reach. Use when user says "impact check", "check impact", or wants to judge whether an idea/behavior matters before committing.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 3 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Check whether a proposed idea studies an *important* problem/behavior — one worth committing effort to: $ARGUMENTS

    line 10
  2. Distinctive:

    Read the description and name the behavior/phenomenon or problem under study (not the method).

    line 30
  3. Very specific:

    Call the external LLM reviewer via mcp__llm-chat__chat.

    line 48
  4. Distinctive:

    Ask: "Is this problem important?

    line 53
  5. Very specific:

    After each mcp__llm-chat__chat reviewer call, save the trace following shared-references/review-tracing.md.

    line 86

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Impact Check Skill

Check whether a proposed idea studies an important problem/behavior — one worth committing effort to: $ARGUMENTS

What Counts as Impact

An idea is high-impact to the extent it does ANY of the following:

  • solves an important problem;
  • is likely to be widely used or cited by follow-up research;
  • could change the direction of a research area;
  • helps real applications, industry, society, or cross-disciplinary research;
  • reveals an important phenomenon, even if the method is simple.

Constants

  • REVIEWER_BACKEND = llm-chat — External LLM reviewer via llm-chat MCP (model defers to LLM_MODEL env). Always ask the external reviewer for strict, high-rigor feedback.

Instructions

Given an idea / behavior description, systematically assess its importance:

Phase A: Extract the Impact-Bearing Claims

  1. Read the description and name the behavior/phenomenon or problem under study (not the method).
  2. Extract the elements that determine its importance:
    • What problem does it address, and who actually has that problem?
    • What downstream research or applications would build on it if the result holds?
    • What would change — in the field or in practice — if it is true?
    • What is the reach: one narrow setting, a whole research area, or real-world / cross-disciplinary use?
  3. State the single strongest one-line case for why it matters.

Phase B: Assess Impact Along the Dimensions

For EACH impact dimension below, judge how strongly the idea scores and gather supporting evidence (use WebSearch / WebFetch to check whether the problem is an open/active question, how much attention it gets, and where it would be used):

  1. Important problem — Is this a problem the field (or a real application) actually needs solved, or a niche curiosity?
  2. Uptake / citation — Would follow-up research likely build on, use, or cite this? Does it produce a reusable artifact (dataset, method, finding, diagnostic)?
  3. Direction-shifting — Could the result change how people think about or approach a research area?
  4. Real-world reach — Does it help applications, industry, society, or cross-disciplinary work?
  5. Phenomenon value — Even if the method is simple, does the result reveal an important phenomenon?

Phase C: Cross-Model Verification

Call the external LLM reviewer via mcp__llm-chat__chat. Always ask for strict, high-rigor feedback.

Prompt should include:

  • The idea / behavior description
  • Your per-dimension assessment from Phase B
  • Ask: "Is this problem important? Who would care, and how far would the result reach? What is the strongest 'so what?' objection?"

Phase D: Impact Report

Output a structured report:

## Impact Check Report

### Studied Problem/Behavior
[1-2 sentence description — the behavior/problem, not the method]

### Impact Dimensions
1. Important problem — HIGH/MEDIUM/LOW — [why]
2. Uptake / citation — HIGH/MEDIUM/LOW — [why]
3. Direction-shifting — HIGH/MEDIUM/LOW — [why]
4. Real-world reach — HIGH/MEDIUM/LOW — [why]
5. Phenomenon value — HIGH/MEDIUM/LOW — [why]

### Overall Impact Assessment
- Score: X/10
- Recommendation: PROCEED / PROCEED WITH CAUTION / DEPRIORITIZE
- Why it matters: [the strongest case, one sentence]
- "So what?" risk: [the strongest objection a reviewer would raise about importance]
- Who would care: [the audience that benefits most]

Important Rules

  • Be BRUTALLY honest — committing to an unimportant problem wastes months of research time.
  • "Interesting" is not "important". Apply the "so what?" test: if the result came out either way, would anyone change what they do?
  • A simple method can be high-impact if it reveals an important phenomenon — do not penalize simplicity.

Review Tracing

After each mcp__llm-chat__chat reviewer call, save the trace following shared-references/review-tracing.md. Write files directly to .mechanist/traces/<skill>/<date>_run<NN>/. Respect the --- trace: parameter (default: full).

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.