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.content-media
Create, read, edit .pptx decks, slides, notes, templates.
content-media
Create, read, edit .pptx decks, slides, notes, templates.
documentation
Extract text from PDFs/scans (pymupdf, marker-pdf).
documentation
Extract text from PDFs/scans (pymupdf, marker-pdf).