configs/hermes/default/skills/research/research-proposal-interview/SKILL.md
Conducts a structured Socratic interview to produce a comprehensive markdown research proposal that handles cascading uncertainty (fixed end-question, branching experiments). Use this skill whenever the user wants to write a research proposal, research plan, study design, experiment plan, thesis proposal, RFC, or "spec out" a research direction — even if they don't explicitly say "interview me." Trigger when the user says things like "help me plan this research", "I want to design experiments for X", "draft a proposal for...", "think through a research direction", or shares a half-formed research idea and asks for help structuring it. The skill interviews the user, challenges their priors with evidence requests and falsifiers, optionally uses sub-agents to explore prior art, and builds the proposal markdown incrementally so context stays clean and the document is always grounded.
npx skillsauth add poorrican/dotfiles research-proposal-interviewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Runs the human-facing interview layer for building a research proposal.
Use research-proposal-structure as the canonical definition of the artifact itself. This interview skill is intentionally thinner: it focuses on elicitation, challenge, sequencing, and incremental writing discipline rather than re-specifying the full proposal schema.
The output still becomes the standard proposal artifact, but this skill's job is to get high-quality content into that artifact through a structured Socratic process.
Trigger on any request resembling: "draft a research proposal," "help me design a study," "plan experiments for X," "spec out this research direction," "write a thesis proposal," or a user dropping a half-baked research idea and asking for structure. Also trigger when an existing rough plan needs to be sharpened into a proposal — start by reading what they have, then enter the interview loop from wherever the gaps are biggest.
Do NOT use for:
research-proposal-structure.Ask one opening question: "What's the end question this research needs to answer, and what's your current best guess at the answer?"
Get a one-paragraph reply. Do not begin the full interview yet.
Then immediately:
research-proposal-structure.references/template.md to a working file (default: proposal.md in the current working directory unless the user specifies another path).This early scaffold is mandatory. The document becomes the source of truth; the chat becomes the workbench.
Read references/interview-guide.md once. It contains the canonical question set and challenge prompts.
Drive the conversation section-by-section, but rely on research-proposal-structure for what each section must contain.
Interview discipline:
[TODO: needs sharpening] and move on.Read references/exploration.md for exact prompts.
Three exploration moments are worth the latency:
Condense sub-agent output into 3–6 bullets before it touches the document. Bring the most important finding back to the user as a question, not a lecture.
Once at least one immediate experiment is specified, make sure the proposal includes:
Push to retain at least the falsifier alongside the confirmatory test.
When all sections have content:
Surface inconsistencies briefly, apply fixes, and present the final file path.
Write the doc early and keep it current. If the interview has gone several turns without updating the file, stop and write.
One question at a time. The interview is Socratic, not a survey.
Challenge to strengthen, not to dominate. Surface one assumption, ask for evidence, propose one alternative, then move on.
Sub-agents return summaries, not transcripts. Keep the main thread centered on the user.
The structure lives in the companion skill. If you find yourself re-deriving the proposal schema, reload research-proposal-structure and conform to it.
references/template.md — proposal scaffold copied at the start.references/interview-guide.md — interview questions and challenge prompts.references/exploration.md — sub-agent / scoped-pass prompts.development
Implement multiple GitHub issues sequentially as stacked branches in separate worktrees, with an implementer sub-agent and an independent reviewer sub-agent per issue. Use when the user gives you two or more dependent issues and asks for them to be implemented in order, or says "stacked branches", "sequential issues", "issue chain", "do these in worktrees", or describes a parent epic with child issues that build on each other. Also reach for this whenever the user wants implementation and verification done by separate agents.
testing
Use when an agent needs to produce, update, validate, or normalize a standardized research proposal artifact without running an interview. Defines the canonical structure, confidence-tag semantics, decision logic, and completion checks for proposal.md-style research plans.
testing
Use when an agent needs to produce, update, validate, or normalize a standardized experiment-log entry without running an interview. Defines the canonical structure, pre-registration rules, evidence/interpretation split, calibration tags, and append-only revision model for durable experiment records.
testing
Conducts a structured Socratic interview to produce or update a single experiment log entry — the durable record of what was run, what it showed, and what it means. Use this skill whenever the user wants to log an experiment, write up results, record a backtest, capture a finding, pre-register a run, document a study, or update an existing entry with new results or a revised interpretation. Trigger on phrases like "log this experiment," "write up the results of...", "I ran X, help me document it," "pre-register this," "update the entry for...", or when the user shares results and asks for help interpreting and recording them. The skill enforces the four-way separation between what happened, what it means, what it implies, and what comes next; challenges the user's interpretations with evidence requests and alternative explanations; and writes incrementally to keep context clean and the entry always grounded.