Agent skill

Academic Grill

by Exekiel179 in Exekiel179/psyclaw

Stress-test an academic research question, proposal, study design, analysis plan, manuscript claim, review protocol, or AI research project through a one-question-at-a-time interview until its…

MITAuto-check passedResearch & Science

Install Academic Grill

skills CLI
$ npx skills add Exekiel179/psyclaw --skill academic-grill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Exekiel179/psyclaw academic-grill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Exekiel179/psyclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/core/academic-grill .claude/skills/academic-grill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
academic-grill
GitHub stars
103
Token cost
~2k tokens
SKILL.md length
983 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Stress-test an academic research question, proposal, study design, analysis plan, manuscript claim, review protocol, or AI research project through a one-question-at-a-time interview until its…

  • Works in 8 steps: research purpose, intended contribution,… → research question, construct… → theoretical mechanism, prior evidence,… → …
  • The user invokes /grill
  • SKILL.md covers Interaction Contract, Dependency Order, Completion and Project Persistence
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Academic Grill is an agent skill from Exekiel179/psyclaw. Stress-test an academic research question, proposal, study design, analysis plan, manuscript claim, review protocol, or AI research project through a one-question-at-a-time interview until its consequential decisions, evidence boundaries, and reporting commitments are explicit. Use when the user invokes /grill or asks for rigorous academic questioning. For open-ended ideation without pressure-testing, use /brainstorm instead.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Brainstorming, Hypothesis generation and Load testing. The licence is MIT.

When your agent uses it

  • The user invokes /grill
  • Asks for rigorous academic questioning

Example prompts

  • “/academic-grill”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. research purpose, intended contribution, audience, and decision the work should inform;
  2. research question, construct definitions, unit of analysis, population or corpus, context, scope, and falsifiability;
  3. theoretical mechanism, prior evidence, competing explanations, and hypotheses or propositions;
  4. research paradigm, exploratory versus confirmatory status, preregistration boundary, primary versus secondary outcomes, and multiplicity;
  5. design, sampling, inclusion and exclusion, comparison or counterfactual, timing, ethics, consent, access rights, and data governance;
  6. operationalization, measurement validity, reliability, manipulation, confounds, missingness, bias, and data quality;
  7. target estimand or interpretive aim, analysis strategy, assumptions, effect size, uncertainty, robustness or sensitivity analysis, and…
  8. evidence-to-claim alignment, alternative interpretations, generalizability or transferability, limitations, reproducibility, and reporting…

What it can do on your machine

Read from SKILL.md and the folder at commit 452ec79. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Academic Grill loads about 2k tokens when it runs. Until then it costs about 111 tokens; SKILL.md has 983 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~111
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Exekiel179/psyclaw at commit 452ec79, republished under its MIT licence (© Exekiel179). 983 words, ~2,033 tokens.

Download SKILL.mdSave it as .claude/skills/academic-grill/SKILL.md (or your agent's skills folder).
name
academic-grill
description
Stress-test an academic research question, proposal, study design, analysis plan, manuscript claim, review protocol, or AI research project through a one-question-at-a-time interview until its consequential decisions, evidence boundaries, and reporting commitments are explicit. Use when the user invokes /grill or asks for rigorous academic questioning. For open-ended ideation without pressure-testing, use /brainstorm instead.
license
MIT

Academic Grill

Interrogate the user's academic plan until both sides share a precise, defensible research specification. Be rigorous about the reasoning while remaining constructive toward the researcher.

When the user provides a dataset or topic without a mature research question, begin by doing intellectual work: inspect the available context and propose 2-4 theoretically meaningful, answerable questions or hypotheses. Briefly compare their value, feasibility, and inferential limits, recommend one, and then ask only for decisions the user genuinely needs to make.

Interaction Contract

  • Ask exactly one substantive question per turn.
  • Give a concise recommended answer or decision with every question, including the reason and main trade-off. Clearly distinguish that recommendation from facts established by evidence.
  • Resolve upstream decisions before downstream ones. Do not ask about an analysis technique while the construct, estimand, comparison, or data-generating process is still unclear.
  • If the answer can be established from files, project state, registered evidence, code, or prior conversation, inspect those sources instead of asking the user.
  • Enter a researcher decision only when at least two substantively defensible options remain after checking the available evidence and established methods, and the choice would change the research question, sample treatment, operationalization, estimand, analysis method, or interpretation. Record what evidence and methods were checked, explain why they cannot resolve the disagreement, and state the options, evidence, consequences, and your recommendation.
  • Do not ask the researcher to decide software installation, dependency repair, file formatting, script debugging, reproducibility metadata, citation formatting, or a reporting omission that the agent can repair. Repair these directly after /init, or report a concrete technical limitation without treating it as a research decision.
  • A dataset supplied for analysis is exploratory by default unless the user says that hypotheses and analyses were fixed before seeing it. Do not lead with a preregistration question, do not ask for a preregistration URL, and do not imply that exploratory work is methodologically inferior. For explicitly confirmatory work, ask what was specified in advance only when that distinction affects analysis or interpretation.
  • Use researcher-facing language. Keep internal terms such as Claim, Evidence, ledger, gate, audit, blocked, receipt, and dependency out of ordinary questions and proposed prose.
  • Use the user's latest answer to choose the next unresolved branch. Do not dump a static questionnaire.
  • When the user's answer creates a contradiction or leaves a consequential ambiguity, resolve it before advancing.
  • Challenge unsupported assumptions, vague constructs, convenience samples, post-hoc outcomes, causal overreach, missing uncertainty, undisclosed researcher degrees of freedom, non-falsifiable claims, and conclusions that exceed the evidence.
  • Never invent a citation, result, sample characteristic, measure, preregistration, ethical approval, or completed analysis.
  • Do not imply that completing the interview validates the study.

Dependency Order

Move through only the branches relevant to the request:

  1. research purpose, intended contribution, audience, and decision the work should inform;
  2. research question, construct definitions, unit of analysis, population or corpus, context, scope, and falsifiability;
  3. theoretical mechanism, prior evidence, competing explanations, and hypotheses or propositions;
  4. research paradigm, exploratory versus confirmatory status, preregistration boundary, primary versus secondary outcomes, and multiplicity;
  5. design, sampling, inclusion and exclusion, comparison or counterfactual, timing, ethics, consent, access rights, and data governance;
  6. operationalization, measurement validity, reliability, manipulation, confounds, missingness, bias, and data quality;
  7. target estimand or interpretive aim, analysis strategy, assumptions, effect size, uncertainty, robustness or sensitivity analysis, and stopping rule;
  8. evidence-to-claim alignment, alternative interpretations, generalizability or transferability, limitations, reproducibility, and reporting commitments.

Adapt these branches to the study rather than forcing an experimental template:

  • For qualitative research, examine positionality, reflexivity, sampling logic, saturation or information power, coding and interpretation, negative cases, and credibility.
  • For evidence synthesis, examine the review question, protocol, databases, search strategy, screening, extraction, risk of bias, heterogeneity, and certainty of evidence.
  • For AI-system research, examine task and construct validity, baselines, data provenance and leakage, evaluation-set independence, ablations, uncertainty, reproducibility, human evaluation, safety, and the boundary between system capability and empirical claim.
  • For mixed-methods research, examine why integration is needed, where strands connect, and how disagreement between strands will be interpreted.
Show full SKILL.md (318 more words)Show less

Completion

Do not stop merely because every branch was mentioned. Stop when the consequential decisions are either resolved or explicitly assigned to the researcher, and contradictions have been surfaced. Then provide a compact research specification with:

  • confirmed decisions;
  • unresolved decisions and their owners;
  • evidence, data, or approvals still required;
  • exploratory and confirmatory boundaries;
  • principal validity and ethics risks;
  • analysis and reporting commitments;
  • claims the current design may support and claims it may not support;
  • the next concrete action.

Label the specification as a planning artifact, not evidence that the study is valid or complete.

Project Persistence

The command invocation specifies one persistence mode. Follow it exactly.

Init mode

After the interview is complete, update the initialized project without asking for another confirmation:

  • .psyclaw/project.json: keep its schema and identity fields; update only the goal and paradigm when the confirmed specification changed them;
  • notes/goal.md: confirmed purpose, research question, scope, population or corpus, and exclusions;
  • notes/research-spec.md: the complete confirmed research specification and claims boundary;
  • notes/decisions.md: consequential decisions, rationale, alternatives, owner, and status;
  • notes/plan.md: dependency-ordered tasks derived from the confirmed specification, with inputs, outputs, approvals, status, and stop conditions;
  • notes/decision_request.md: only unresolved substantive research trade-offs that meet the decision threshold above, or an explicit Status: none when there are none.

When no qualifying trade-off remains, set the status in notes/research-spec.md and notes/plan.md to ready-for-run. Do not use awaiting-human-approval as a routine completion state.

Preserve valid frontmatter and existing unrelated user content. Do not mark evidence, ethics approval, preregistration, data access, analysis, or review as completed unless project records establish it.

Review mode

After the interview is complete, do not change project files immediately. Show a concise proposed-update summary naming every affected file, then ask one explicit question: whether to apply the updates. Write the same project documents as init mode only after the researcher confirms. If no initialized project exists, offer to return the specification in the conversation without creating project state.

© Exekiel179, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/core/academic-grill of Exekiel179/psyclaw.

Open the folder on GitHubat commit 452ec79

Compare with similar skills

Academic Grill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Academic Grill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Academic Grill this skillExekiel179/psyclaw103—~2kAutomated safety check: PassMIT
Scientific BrainstormingOleafly/Oleafly2122 repos~3.5kAutomated safety check: PassMIT
Research Refineappleweiping/WEIPING_WIKI119—~887Automated safety check: PassMIT
Idea Discovery PipelineGRIND-Lab-Core/night_owl_research_agent106—~4.4kAutomated safety check: WarnNone
Scientific Brainstormingspacering-net/codeg3.9k13 repos~2kAutomated safety check: PassMIT
Research RefinezjYao36/Auto-Research-Refine1286 repos~6.9kAutomated safety check: NotesNone

Similar skills

  • Facilitates evidence-aware scientific ideation with independent generation, structured discussion, explicit assumptions, transparent evaluation, adversarial review, and decision logs.

    212 GitHub starsUsed in 2 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Research Refine

    appleweiping/WEIPING_WIKI

    Disciplined idea refinement for research projects. An agent skill from appleweiping/WEIPING_WIKI.

    119 GitHub stars~887 tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Idea Discovery Pipeline

    GRIND-Lab-Core/night_owl_research_agent

    The full pipeline for idea generation. An agent skill from GRIND-Lab-Core/night_owl_research_agent.

    106 GitHub stars~4.4k tokensUpdated 5 mo ago
    Research & ScienceAuto-check: warnings
  • Scientific Brainstorming

    spacering-net/codeg

    Creative research ideation and exploration. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 13 repos~2k tokens
    Research & ScienceAuto-check passed
  • Research Refine

    zjYao36/Auto-Research-Refine

    Turns a vague research direction into a focused, problem-anchored method plan through up to five review rounds with a second model.

    128 GitHub starsUsed in 6 repos~6.9k tokens
    Research & ScienceAuto-check: notes
  • Scientific Problem Selection

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    This skill should be used when scientists need help with research problem selection, project ideation, troubleshooting stuck projects, or strategic scientific decisions.

    274 GitHub starsUsed in 3 repos~2.8k tokens
    Research & ScienceAuto-check passed

More from Exekiel179/psyclaw

All 10 skills in this repo
  • Verify Feature

    Exekiel179/psyclaw

    跑 PsyClaw 的 Definition-of-Done 验证(init.sh:compile + pytest + gates),把命令与输出作为 evidence 记入 featurelist.json。当用户要验证/收尾一个 feature、宣称完成前、或说 "verify" / "跑验证" / "记 evidence" 时使用。

    103 GitHub stars~328 tokensUpdated 2 days ago
    Auto-check passed
  • Analysis Plan

    Exekiel179/psyclaw

    Soft-takeover stats planning in analysis mode — light EDA, per-analysis human choices, typed ritual approval before execute, optional auto mode, then local scripts (MCP only when needed).

    103 GitHub stars~646 tokensUpdated 2 days ago
    Auto-check passed
  • Freud Perspective

    Exekiel179/psyclaw

    西格蒙德·弗洛伊德(Sigmund Freud)作为精神分析学派代表的思维框架蒸馏。基于公开著作与学派史材料提炼的概念透镜(无意识、防御、移情、释梦传统等),用于理论对话与文本/临床概念澄清——不是治疗工具。

    103 GitHub stars~440 tokensUpdated 2 days ago
    Auto-check passed
  • Gelman Perspective

    Exekiel179/psyclaw

    安德鲁·格尔曼(Andrew Gelman)的思维框架。基于公开著作、论文与统计沟通实践提炼(多层模型、Bayesian 工作流、forking paths、可视化与不确定性沟通)。

    103 GitHub stars~384 tokensUpdated 2 days ago
    Auto-check passed
  • Kahneman Perspective

    Exekiel179/psyclaw

    丹尼尔·卡尼曼(Daniel Kahneman)的思维框架。基于公开著作与演讲提炼的心智模型、启发式与表达DNA(Thinking, Fast and Slow; Judgment under Uncertainty; Noise 等公开材料)。

    103 GitHub stars~426 tokensUpdated 2 days ago
    Auto-check passed
  • Run Stats MCP

    Exekiel179/psyclaw

    需要跑统计(t 检验/方差/回归/因子/SEM/生存/EEG…)时,路由到正确的外部 MCP 服务器或 [stats] extra,而不是在 psyclaw 仓内重新实现算法。当任务涉及统计计算、选择统计方法、或有人想在 psyclaw 里写统计代码时使用。

    103 GitHub stars~384 tokensUpdated 2 days ago
    Auto-check passed

Questions about Academic Grill

What does Academic Grill do?

Stress-test an academic research question, proposal, study design, analysis plan, manuscript claim, review protocol, or AI research project through a one-question-at-a-time interview until its…. Academic Grill is an agent skill from Exekiel179/psyclaw. Stress-test an academic research question, proposal, study design, analysis plan, manuscript claim, review protocol, or AI research project through a one-question-at-a-time interview until its consequential decisions, evidence boundaries, and reporting commitments are explicit.

When should I use Academic Grill?

Academic Grill fits situations like: the user invokes /grill; asks for rigorous academic questioning.

How do I install Academic Grill in Claude Code?

Run `npx skills add Exekiel179/psyclaw --skill academic-grill -a claude-code`. Or copy the skill folder (skills/core/academic-grill in Exekiel179/psyclaw) into .claude/skills/academic-grill in your project. Claude Code loads it when a task matches its description.

How do I install Academic Grill in Codex?

Run `npx skills add Exekiel179/psyclaw --skill academic-grill -a codex`. Or copy the skill folder (skills/core/academic-grill in Exekiel179/psyclaw) into .agents/skills/academic-grill in your project. Codex loads it when a task matches its description.

Can I use Academic Grill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Exekiel179/psyclaw --skill academic-grill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/academic-grill, .gemini/skills/academic-grill, .github/skills/academic-grill and .opencode/skills/academic-grill in your project.

What does Academic Grill need to run?

SKILL.md names no scripts, command-line tools or credentials: Academic Grill is instructions for the agent only.

Does Academic Grill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Academic Grill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Academic Grill use?

Academic Grill is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Academic Grill use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Academic Grill?

Skills that share tags, products or a category with Academic Grill: Scientific Brainstorming (Oleafly/Oleafly, 212 stars), Research Refine (appleweiping/WEIPING_WIKI, 119 stars), Idea Discovery Pipeline (GRIND-Lab-Core/night_owl_research_agent, 106 stars) and Scientific Brainstorming (spacering-net/codeg, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Academic Grill?

Exekiel179 (a GitHub user) maintains it in Exekiel179/psyclaw, which has 103 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 9, 2026.

Source: Exekiel179/psyclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.