Show Me Your Work Decision Log
cursor/plugins
Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.
Core scientific methodology principles: research planning, method justification, assumption checking, and human-in-the-loop decision making for cognitive science and neuroscience
$ npx skills add NeuroAIHub/BrainPilot --skill research-literacy -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install NeuroAIHub/BrainPilot research-literacy --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/NeuroAIHub/BrainPilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy .claude/skills/research-literacy && rm -rf skills-srcUse ~/.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/
Install the "research-literacy" agent skill from https://github.com/NeuroAIHub/BrainPilot/tree/main/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy into .claude/skills/research-literacy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-literacy", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/NeuroAIHub/BrainPilot/tree/main/packages/skills/skills/02_Cross-Domain_Foundation/research-literacyType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add NeuroAIHub/BrainPilot --skill research-literacy -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install NeuroAIHub/BrainPilot research-literacy --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NeuroAIHub/BrainPilot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy .agents/skills/research-literacy && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "research-literacy" agent skill from https://github.com/NeuroAIHub/BrainPilot/tree/main/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy into .agents/skills/research-literacy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-literacy", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add NeuroAIHub/BrainPilot --skill research-literacy -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install NeuroAIHub/BrainPilot research-literacy --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NeuroAIHub/BrainPilot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy .cursor/skills/research-literacy && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "research-literacy" agent skill from https://github.com/NeuroAIHub/BrainPilot/tree/main/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy into .cursor/skills/research-literacy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-literacy", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/NeuroAIHub/BrainPilot.git --path packages/skills/skills/02_Cross-Domain_Foundation/research-literacy--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add NeuroAIHub/BrainPilot --skill research-literacy -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install NeuroAIHub/BrainPilot research-literacy --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NeuroAIHub/BrainPilot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy .gemini/skills/research-literacy && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "research-literacy" agent skill from https://github.com/NeuroAIHub/BrainPilot/tree/main/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy into .gemini/skills/research-literacy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-literacy", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install NeuroAIHub/BrainPilot research-literacyInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add NeuroAIHub/BrainPilot --skill research-literacy -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/NeuroAIHub/BrainPilot.git skills-src && mkdir -p .github/skills && cp -r skills-src/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy .github/skills/research-literacy && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "research-literacy" agent skill from https://github.com/NeuroAIHub/BrainPilot/tree/main/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy into .github/skills/research-literacy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-literacy", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add NeuroAIHub/BrainPilot --skill research-literacy -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install NeuroAIHub/BrainPilot research-literacy --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NeuroAIHub/BrainPilot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy .opencode/skills/research-literacy && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "research-literacy" agent skill from https://github.com/NeuroAIHub/BrainPilot/tree/main/packages/skills/skills/02_Cross-Domain_Foundation/research-literacy into .opencode/skills/research-literacy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "research-literacy", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
research-literacyCore scientific methodology principles: research planning, method justification, assumption checking, and human-in-the-loop decision making for cognitive science and neuroscience
Research Literacy is an agent skill from NeuroAIHub/BrainPilot. Core scientific methodology principles: research planning, method justification, assumption checking, and human-in-the-loop decision making for cognitive science and neuroscience
Its SKILL.md is about 4.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/common-assumptions.md` and `references/planning-template.md`).
It sits in Agent Workflows, covering Human-in-the-loop approvals and Hypothesis generation. The repository describes itself as: BrainPilot: Automating Brain Discovery with Agentic Research. The licence is AGPL-3.0.
12 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 93f6855. It shows what the files ask for, not the result of running them.
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.
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.
Links to these hosts (documentation or services it may open):
github.comFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Research Literacy loads about 4.5k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 49 tokens; SKILL.md has 2,292 words of instructions outside code blocks.
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.
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.
The full file from NeuroAIHub/BrainPilot at commit 93f6855, republished under its AGPL-3.0 licence (© NeuroAIHub). 2,292 words, ~4,492 tokens.
.claude/skills/research-literacy/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.AI agents tend to execute analysis steps immediately without planning or justification. In research, every analysis decision needs a rationale grounded in theory, design, and data characteristics. This skill encodes the basic scientific thinking that should precede any domain-specific action.
A competent programmer without research training will typically: (a) pick a familiar method rather than the appropriate one, (b) skip assumption checks, (c) interpret results without considering alternative explanations, and (d) make undisclosed analytic choices that inflate false positive rates. This skill exists to prevent all four failure modes.
This skill was generated by AI from academic literature. All parameters, thresholds, and citations require independent verification before use in research. If you find errors, please open an issue.
A research question must be specific, falsifiable, and operationalized before any data analysis begins.
Adapted from evidence-based medicine, PICOS structures research questions systematically:
| Element | General Definition | Cognitive Science Example |
|---|---|---|
| Population | Who is studied | Healthy adults aged 18-35; patients with aphasia |
| Intervention / Exposure | What manipulation or variable | Semantic priming; TMS to DLPFC |
| Comparison | What is the control condition | Unrelated prime; sham stimulation |
| Outcome | What is measured | N400 amplitude; reaction time; BOLD signal |
| Study design | How is the study structured | Within-subjects; longitudinal; cross-sectional |
This distinction is critical for valid inference (Wagenmakers et al., 2012):
Rule: Always declare whether an analysis is confirmatory or exploratory before executing it. If the analysis plan changed after seeing the data, label it exploratory.
| Research Question Type | Analysis Family | Examples |
|---|---|---|
| Group differences | Comparison | t-test, ANOVA, Mann-Whitney, permutation test |
| Relationships between variables | Association | Correlation, regression, structural equation modeling |
| Predicting outcomes | Prediction | Regression, classification, machine learning |
| Describing patterns | Description | Descriptive statistics, factor analysis, clustering |
| Temporal dynamics | Time-series | Time-frequency, autoregressive models, HMM |
| Neural representations | Multivariate | RSA, MVPA, encoding models |
When choosing a method, consider and document the following:
references/common-assumptions.md for method-specific guidance.references/common-assumptions.md."If all you have is a hammer, everything looks like a nail."
This anti-pattern occurs when a researcher applies the method they are most comfortable with, regardless of whether it is appropriate. Examples:
Rule: Always articulate why THIS method and not alternatives. Document the alternatives considered and why they were rejected.
Before running any analysis, declare what each possible outcome means:
Declaring expected outcomes in advance prevents:
No statistical method is assumption-free. Before applying any method, identify its key assumptions and check them. The full reference table is in references/common-assumptions.md.
Every study has limitations. Common categories:
Rule: List limitations upfront, not as an afterthought. This is not a weakness; it is scientific rigor.
Research involves judgment calls where reasonable experts disagree. These "researcher degrees of freedom" (Simmons et al., 2011) can inflate false positive rates from a nominal 5% to as high as 60% when left unchecked (Simmons et al., 2011). AI agents must not make these decisions silently.
ALWAYS present the analysis plan and WAIT for user confirmation before proceeding at these decision points:
These are well-documented threats to research integrity. An AI agent must actively avoid them and flag when a user's request risks falling into one.
Running multiple analyses, selectively reporting significant results, or tweaking analysis parameters until p < .05. Simulations show this can inflate false positive rates from 5% to over 60% (Simmons et al., 2011, Psychological Science, 22(11), 1359-1366).
How to avoid: Preregister analyses. Report all analyses conducted. Use correction for multiple comparisons.
Presenting post-hoc hypotheses as if they were a priori predictions (Kerr, 1998, Personality and Social Psychology Review, 2(3), 196-217).
How to avoid: Write down hypotheses before analysis. Clearly label any post-hoc exploration.
Selectively reporting evidence that supports preferred conclusions while downplaying contradictory evidence.
How to avoid: Report effect sizes and confidence intervals for all outcomes, not just significant ones. Use adversarial collaboration or preregistered analysis plans.
Even without deliberate p-hacking, undisclosed analytic flexibility creates a "garden of forking paths" where many analysis pipelines could have been chosen, inflating the effective number of comparisons (Gelman & Loken, 2014, American Scientist, 102(6), 460-465).
How to avoid: Document every analytic decision and its alternatives. Consider multiverse analysis (Steegen et al., 2016).
Applying statistical procedures as rituals without understanding the underlying assumptions or logic. The "null ritual" — mechanically testing H0 at alpha = .05 without specifying H1, considering effect sizes, or evaluating power — is the canonical example (Gigerenzer, 2004, Journal of Socio-Economics, 33, 587-606).
How to avoid: For every test, articulate: What is H0? What is H1? What is the expected effect size? What is the power? Is the test appropriate for this data structure?
Changing the primary outcome variable after seeing the data because the original outcome was not significant.
How to avoid: Preregister primary and secondary outcomes. Report results for the preregistered primary outcome regardless of significance.
This is the core procedure. Execute these steps before any analysis.
Write the question in one sentence. It must be specific, testable, and falsifiable. Use the PICOS framework above.
If confirmatory, a preregistered hypothesis must exist. If exploratory, label all results as hypothesis-generating.
Name the method, explain why it is appropriate for this question and data, and list alternatives that were considered and why they were rejected.
For each hypothesis, state what supporting, refuting, and ambiguous results would look like, with expected effect sizes where possible.
Enumerate the method's statistical assumptions and how they will be checked. List known limitations of the design and analysis.
Show the complete plan in a structured format (see references/planning-template.md). Include decision points where user input is required.
Do not proceed until the user approves the plan or requests modifications.
After analysis, explicitly compare results to the expected outcomes declared in Step 4. Discuss discrepancies honestly.
Reiterate limitations, including any that became apparent during analysis (e.g., assumption violations, unexpected data patterns).
© NeuroAIHub, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 2 other files (references) in packages/skills/skills/02_Cross-Domain_Foundation/research-literacy of NeuroAIHub/BrainPilot.
Open the folder on GitHubat commit 93f6855
Research Literacy 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Research Literacy this skillNeuroAIHub/BrainPilot | 1.1k | — | ~4.5k | Automated safety check: Pass | AGPL-3.0 | |
| Show Me Your Work Decision Logcursor/plugins | 11k | 8 repos | ~1.6k | Automated safety check: Pass | None | |
| Darwin Skill Optimizeralchaincyf/darwin-skill | 6.2k | 1 repos | ~4.7k | Automated safety check: Pass | MIT | |
| Loop Constraints Enforcercobusgreyling/loop-engineering | 11k | 1 repos | ~475 | Automated safety check: Notes | MIT | |
| Ask User QuestionMemTensor/MemOS | 12k | — | ~1k | Automated safety check: Pass | Apache-2.0 | |
| PUA High-Agency Governancetanweai/pua | 20k | — | ~502 | Automated safety check: Pass | MIT |
cursor/plugins
Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.
alchaincyf/darwin-skill
Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.
cobusgreyling/loop-engineering
Loads a project's loop-constraints.md before any other action and blocks pushes, edits or merges that violate the rules it defines.
MemTensor/MemOS
Shows a question as a modal in the interface to clarify a task, collect a preference or get approval, since the user cannot see terminal output.
tanweai/pua
Pushes an agent to keep verifying and changing approach after repeated failures, using a diagnosis line, evidence-based completion and confirmation before risky edits.
rohitg00/agentmemory
Deletes chosen memories from agentmemory only after showing the matches and getting an explicit yes, for privacy requests and cleanup of outdated notes.
NeuroAIHub/BrainPilot
Toolbox for markerless animal pose estimation with DeepLabCut.
NeuroAIHub/BrainPilot
Preprocess task-based or resting-state fMRI data with fMRIPrep — a robust, BIDS-App preprocessing pipeline built on FSL, ANTs, FreeSurfer, AFNI, and Nilearn.
NeuroAIHub/BrainPilot
Domain-validated pipeline guidance for EEG/MEG data analysis using MNE-Python: data loading, preprocessing (filtering, ICA, re-referencing), epoching, ERP/ERF computation, time-frequency…
NeuroAIHub/BrainPilot
Domain-validated guidance for network neuroscience analysis using netneurotools: datasets, brain network metrics, connectivity consensus, modularity, spatial statistics, null models, and cortical…
NeuroAIHub/BrainPilot
Submission-grade Nature/high-impact journal figure workflow for Python or R.
NeuroAIHub/BrainPilot
Domain-validated guidance for cortical surface visualization and brain surface rendering of fMRI data using pycortex: data types (Volume, Vertex, Dataset), 2D cortical flatmaps, 3D WebGL brain…
Categories
Core scientific methodology principles: research planning, method justification, assumption checking, and human-in-the-loop decision making for cognitive science and neuroscience. Research Literacy is an agent skill from NeuroAIHub/BrainPilot.
Research Literacy fits situations like: tasks that involve Human-in-the-loop approvals; tasks that involve Hypothesis generation.
Run `npx skills add NeuroAIHub/BrainPilot --skill research-literacy -a claude-code`. Or copy the skill folder (packages/skills/skills/02_Cross-Domain_Foundation/research-literacy in NeuroAIHub/BrainPilot) into .claude/skills/research-literacy in your project. Claude Code loads it when a task matches its description.
Run `npx skills add NeuroAIHub/BrainPilot --skill research-literacy -a codex`. Or copy the skill folder (packages/skills/skills/02_Cross-Domain_Foundation/research-literacy in NeuroAIHub/BrainPilot) into .agents/skills/research-literacy in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add NeuroAIHub/BrainPilot --skill research-literacy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/research-literacy, .gemini/skills/research-literacy, .github/skills/research-literacy and .opencode/skills/research-literacy in your project.
SKILL.md names no scripts, command-line tools or credentials: Research Literacy is instructions for the agent only.
SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.
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.
Research Literacy is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 4.5k tokens (SKILL.md is roughly 18k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.4k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Research Literacy: Show Me Your Work Decision Log (cursor/plugins, 11k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars), Loop Constraints Enforcer (cobusgreyling/loop-engineering, 11k stars) and Ask User Question (MemTensor/MemOS, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
NeuroAIHub (a GitHub organization) maintains it in NeuroAIHub/BrainPilot, which has 1,062 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on October 2, 2026.
Source: NeuroAIHub/BrainPilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.