Hypothesis Generation
spacering-net/codeg
Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.
A skill your agent uses when the user explicitly asks to use the informed-patient skill to prepare for a medical appointment, organize symptoms before seeing a doctor, or evaluate the evidence…
The automated check flagged lines worth reading first. See the safety section below.
$ npx skills add DrCatHicks/informed-patient --skill informed-patient -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install DrCatHicks/informed-patient informed-patient --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/DrCatHicks/informed-patient.git skills-src && mkdir -p .claude/skills && cp -r skills-src/informed-patient/skills/informed-patient .claude/skills/informed-patient && 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 "informed-patient" agent skill from https://github.com/DrCatHicks/informed-patient/tree/main/informed-patient/skills/informed-patient into .claude/skills/informed-patient/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "informed-patient", 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/DrCatHicks/informed-patient/tree/main/informed-patient/skills/informed-patientType 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 DrCatHicks/informed-patient --skill informed-patient -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install DrCatHicks/informed-patient informed-patient --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/DrCatHicks/informed-patient.git skills-src && mkdir -p .agents/skills && cp -r skills-src/informed-patient/skills/informed-patient .agents/skills/informed-patient && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "informed-patient" agent skill from https://github.com/DrCatHicks/informed-patient/tree/main/informed-patient/skills/informed-patient into .agents/skills/informed-patient/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "informed-patient", 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 DrCatHicks/informed-patient --skill informed-patient -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install DrCatHicks/informed-patient informed-patient --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/DrCatHicks/informed-patient.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/informed-patient/skills/informed-patient .cursor/skills/informed-patient && 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 "informed-patient" agent skill from https://github.com/DrCatHicks/informed-patient/tree/main/informed-patient/skills/informed-patient into .cursor/skills/informed-patient/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "informed-patient", 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/DrCatHicks/informed-patient.git --path informed-patient/skills/informed-patient--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 DrCatHicks/informed-patient --skill informed-patient -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install DrCatHicks/informed-patient informed-patient --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/DrCatHicks/informed-patient.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/informed-patient/skills/informed-patient .gemini/skills/informed-patient && 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 "informed-patient" agent skill from https://github.com/DrCatHicks/informed-patient/tree/main/informed-patient/skills/informed-patient into .gemini/skills/informed-patient/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "informed-patient", 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 DrCatHicks/informed-patient informed-patientInstalls 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 DrCatHicks/informed-patient --skill informed-patient -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/DrCatHicks/informed-patient.git skills-src && mkdir -p .github/skills && cp -r skills-src/informed-patient/skills/informed-patient .github/skills/informed-patient && 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 "informed-patient" agent skill from https://github.com/DrCatHicks/informed-patient/tree/main/informed-patient/skills/informed-patient into .github/skills/informed-patient/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "informed-patient", 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 DrCatHicks/informed-patient --skill informed-patient -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install DrCatHicks/informed-patient informed-patient --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/DrCatHicks/informed-patient.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/informed-patient/skills/informed-patient .opencode/skills/informed-patient && 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 "informed-patient" agent skill from https://github.com/DrCatHicks/informed-patient/tree/main/informed-patient/skills/informed-patient into .opencode/skills/informed-patient/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "informed-patient", 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.
informed-patientA skill your agent uses when the user explicitly asks to use the informed-patient skill to prepare for a medical appointment, organize symptoms before seeing a doctor, or evaluate the evidence…
Informed Patient is an agent skill from DrCatHicks/informed-patient. Use when the user explicitly asks to use the informed-patient skill to prepare for a medical appointment, organize symptoms before seeing a doctor, or evaluate the evidence behind a diagnosis or treatment. Do not trigger automatically from health questions or symptom mentions alone — requires an explicit request by name.
Its SKILL.md is about 9.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/classification-criteria.md`, `references/evidence-hierarchy.md` and `references/literature-search-strategy.md`).
It sits in Research & Science. The repository describes itself as: A Claude Skill to create an evidence review to inform specific health questions. The licence is CC-BY-4.0.
3 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 3b8583a. 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.
No URLs in SKILL.md.
From 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.
Informed Patient loads about 9.2k tokens when it runs, and up to ~26k if it reads all its reference files. Until then it costs about 85 tokens; SKILL.md has 5,418 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 patterns that need a careful read before installing.
omething — otherwise I'll get started." Do not wait for explicit approval — if the user doesn't correct the framing, proAutomated 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 DrCatHicks/informed-patient at commit 3b8583a, republished under its CC-BY-4.0 licence (© DrCatHicks). 5,418 words, ~9,206 tokens.
.claude/skills/informed-patient/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.People attempting to get answers about their health deserve structured support for thinking clearly about evidence and integrating their personal experience with the existing medical literature. Many people turn to AI for this assistance.
However, without guardrails, AI-assisted medical searches can create biased reasoning about evidence for users. Specific risks include:
This skill helps the user work on being a more effective participant in their own care by introducing explicit steps to encourage over-time symptom awareness. This skill draws from best practices in evidence evaluation such as:
The aim of this Skill is to provide a supportive dialogue that helps the user to assess the strength of evidence for various interpretations of their medical experience, not just provide reassurance or raw information. This skill does not seek to replace the user's medical team, but helps them show up to appointments with organized thinking, sharper questions, and a clearer picture of their own experience.
People who are:
In scope: Physical health conditions. Evidence evaluation. Symptom organization. Appointment preparation.
Out of scope: Mental health self-diagnosis or therapy. Emotional processing of health experiences. Acute emergencies (direct to 911/emergency services). When a user expresses distress about their health situation, acknowledge it briefly and continue the structured work. Aiding the user by going through this process is itself supportive. Do not therapize. Treatment decisions are out of scope.
The skill helps people evaluate evidence and prepare questions. It can help a user assess the research evidence behind a treatment, but do not recommend a treatment. Always direct a user to develop a specific actionable question about a treatment.
Not waiting for the appointment: If the user's own account includes a safety incident (near-misses while driving, fainting, a fall) or an unexplained, unintended change (for example, weight loss without trying), and they have not said a clinician already knows, say once, in one plain sentence, that this is worth telling a clinician now instead of holding it for the appointment. Then continue the structured work. The sentence is about not waiting, not about what it might mean: name no cause, rate no urgency, and give no advice on what to do in the meantime.
Always ask before starting: "Would you like to do a quick exercise to shape your preparation for your next appointment? About 10-15 minutes."
Start task-oriented. If the user is here, they're already doing something useful. Naming the value of the exercise briefly supports self-efficacy without being patronizing.
Default opener (adapt to context, don't recite verbatim):
"Organizing your thinking about this is a useful step. Let's build something you can bring to your next appointment. I'll ask you some questions to understand your situation, then we'll put together a structured document with your symptom picture, what a brief search of the evidence says, and specific questions for your medical team."
If the user expresses frustration or exhaustion (context-sensitive):
Acknowledge it in one sentence — something like "A long diagnostic road is draining, and it makes sense that you're frustrated." Then offer a save and return. Do not therapize in the informed-patient session.
Save and return:
Let the user know early that they don't have to do this all at once. Something like: "We can do this in pieces. Start with whatever feels most useful right now and we can come back to the rest later."
The skill has three phases: a guided interview (where Claude asks questions), a literature search (where Claude finds and evaluates the best available evidence), and a structured evidence evaluation (where Claude provides a framework for thinking through what was found). These produce a single output artifact.
Ask these questions conversationally, not as a form, and not all at once. Group them naturally based on where the user is in their journey. Skip questions that don't apply. The goal is to gather enough information to build a useful artifact.
Required branching questions — ask early, before going deeper:
These questions determine which body of evidence is relevant and should be surfaced in the first exchange, not discovered later:
Do not wait for these to emerge organically. If the user's opening description doesn't answer them, ask directly before moving on.
If the user's opening question is about a specific study, article, or claim: Treat the claim as interview data, not as the deliverable. Acknowledge it, note what condition and question it implies, and proceed with the guided interview: "That study is a useful starting point, let me ask you a few questions so I can put it in context for your specific situation." The claim will be evaluated in Phase 3 as part of the evidence quality assessment, but the literature search should establish the broader evidence landscape first. A single study evaluated in isolation is less useful than a single study situated within the full body of evidence.
Current symptoms:
Timeline:
Medical history context:
What they're looking for:
Build the symptom inventory from their answers using structured dimensions:
These dimensions come from validated clinical assessment approaches. They can help the user offer clinicians structured data instead of a narrative they have to decode during a time-pressured appointment. Refer to references/symptom-inventory-methodology.md for the methodological grounding behind the elicitation sequence, guidance on functional anchors vs. numeric scales, and when to preserve the patient's own language rather than translating it into clinical terminology.
Symptom assessment is non-negotiable on three points — these are required before closing Phase 1:
A symptom timeline. At minimum: when did this start, and has it gotten better, worse, or stayed the same? A clinician cannot evaluate a symptom without a trajectory. If the user says "a while ago" or "it's been bad," ask once for specificity: "Can you give me a rough timeframe — weeks, months, longer?"
One concrete functional impact statement. Encourage the user to record something specific. Instead of, "It affects my life," they should report a concrete impact like "I can't sleep through the night," "I've missed work twice this month," "I stopped going to the gym." This helps make symptoms legible to a clinician in a time-pressured appointment and is often what gets taken seriously. If the user hasn't offered one, ask: "What's the one thing you can't do, or can't do as well, because of this?"
A content validity check. Before closing the interview, ask: "Is there anything about how this affects you that we haven't captured yet?" This is not optional small talk — it is the mechanism by which important symptom information that falls outside standard categories gets surfaced. Patients with understudied, complex, or atypical conditions frequently have the most diagnostically significant information in their answer to this question. If the user answers, add it to the symptom inventory in their own words. Do not rephrase into clinical language if the original wording is more specific or vivid.
For all other dimensions, use judgment: if the user gives a curt or vague answer and the detail seems clinically relevant, ask one follow-up. Do not interrogate. If they decline or don't know, move on.
Classification criteria and multi-system review (conditional): Read references/classification-criteria.md when any of these is true:
A symptom mentioned with no wondering attached does not trigger it. Naming a framework is never applying it, and it does not replace the competing hypotheses in Phase 3.
After the interview and before evidence evaluation, conduct a structured mini literature review. This is one of the most valuable things the skill does: most patients don't know what to search for, don't have access to the right databases, and can't easily distinguish a landmark systematic review from a single case report. Claude does this legwork and shows its work.
Transition from Phase 1 (required, non-blocking): Before beginning the search, state the search framing in 2-3 sentences: what symptom picture you'll be searching against and what diagnostic territory you'll explore. Format like: "Before I search, let me confirm what I'll be looking for: [brief symptom summary]. I'll focus on [conditions/territory]. Correct me if I'm missing something — otherwise I'll get started." Do not wait for explicit approval — if the user doesn't correct the framing, proceed. The purpose is to give the user a chance to redirect, not to create a mandatory gate. State the framing and continue straight into the search in the same turn; do not end your message to wait for a reply. Even if the user asks to skip ahead, still state the framing in one sentence before searching. If classification-criteria guidance was triggered, name the one to three best-fit frameworks in this framing, which may run a sentence or two longer.
Tell the user what's happening:
"Now I'm going to search the medical literature based on what you've told me. I'll share the exact search terms I use so you can see what I looked for — and tell me if I'm missing anything."
This skill supports two search modes. The default is structured search. The user can request open search at any point, or the facilitator can suggest it when the user's situation warrants it.
Structured search (default): Follow the source hierarchy below in order. This ensures systematic coverage and is appropriate for most sessions — especially when the user is early in their diagnostic journey, dealing with a well-studied condition, or using this skill for the first time. The hierarchy is the deliverable: the user gets a reproducible, auditable search with clear source types and quality tags.
Open search: The source hierarchy serves as a starting checklist, not a workflow. After ensuring baseline coverage (at minimum: one systematic review search and one guideline search), follow the evidence where the interview data leads. This mode is appropriate when:
In open search mode, adhere to general documentation and evidence assessment guidelines. Still document every search query, still tag every source with quality indicators, and still report what you couldn't find. Inform the user that open search mode is being used and why.
Structured Search strategy:
Use web search across these source types, in priority order. Full query templates and per-source rationale are in references/literature-search-strategy.md — read it before running the search.
When to stop searching: Work through the hierarchy in order, but stop once the evidence base is sufficient to support the user's questions. If Cochrane and guideline coverage is solid, lower-priority sources can be skipped unless they'd add something new. Use judgment. When you stop early, say so: "I stopped here because the Cochrane and guideline coverage was sufficient — see the informed-patient skill README if you want to force a complete search through all source types."
Search term transparency:
Share every search query with the user as you go. Format like:
"I searched for:
[exact query]— here's what I found."
This models good research practice and lets the user course-correct. They may know terminology, specialist names, or subtype distinctions that improve the search.
For each source found, tag it with a plain-language quality indicator:
Refer to references/evidence-hierarchy.md for how to explain each study type in plain language.
The "what I couldn't find" moment:
This is critical. If the search reveals limited evidence, say so explicitly and name what it means:
"I searched for [terms] and found very little published research. This is itself important information. It tells us this could be an understudied area, which means clinical practice may be based more on expert experience than on rigorous studies."
Absence of evidence is not nothing, it's a finding. It should:
If the evidence is contested (conflicting meta-analyses, guideline disagreements, active scientific debate), name that too. Don't resolve it — present the disagreement clearly and flag it as a metascience concern for the red flags section. Contested evidence should:
Search scope:
Aim for 5-10 key sources that represent the best available evidence. Prioritize quality and relevance over volume. For each hypothesis generated later, there should be at least one relevant source — if there isn't, that's a notable gap to document.
Do not cite sources you haven't actually found and reviewed through web search. If you can only access an abstract rather than the full text, say so: "I could only see the abstract of this study, so I can't assess the full methodology. The abstract reports [X]."
Citation integrity — non-negotiable: Every source in the artifact must include the URL that was returned by the web search tool. Never construct or recall a PMID, DOI, or other identifier from memory — only use identifiers that appeared in an actual search result URL. If a search returned a result but no stable URL is available, describe the source (journal, author, year, title) and note that a direct link could not be retrieved. A source without a verifiable URL is weaker evidence of retrieval than one with a URL — flag it as such rather than omitting it or fabricating an identifier. Frameworks named in references/classification-criteria.md are search pointers, not citations: retrieve them and cite the URL the search returned.
Source-level warnings — use ⚠️ inline: When a source has a nuanced issue that affects how much weight to give it, flag it directly in the source entry with a ⚠️ and a one-sentence explanation — don't bury it in prose, make it impossible to miss. See references/literature-search-strategy.md for the specific warning conditions and phrasing (outdated guidelines, abstract-only access, missing risk-of-bias assessment, small samples, population mismatch).
Evidence Snapshot (required):
Before presenting the detailed source list, synthesize 1-3 bullet points that orient the user to the research landscape. Keep each bullet to 1-2 sentences. These should collectively address:
Format like:
What the research landscape looks like:
- [Well-studied / Moderately studied / Understudied]: [Brief reason — e.g., "Several systematic reviews exist, though most focus on treatment rather than early diagnosis."]
- Strongest relevant finding: [Specific, concrete takeaway from the best source found]
- [If applicable] Clinical challenges: [What the literature says about misdiagnosis, common errors, or diagnostic difficulty — omit if no relevant research found]
The goal is to help the user immediately understand whether they're dealing with a common, well-mapped problem or a more complex, less-charted one, and whether the clinical pathway is typically clear or frequently goes wrong.
Red flags check (run immediately after the literature search, before Phase 3):
Based on what the search revealed, apply the red flags framework now, not later. The literature search is itself the primary input for flags 1, 7, and 10:
Surface the 1-3 most relevant flags at this point and carry them into the output artifact. Flags identified here should shape how confidently evidence is presented in Phase 3. A condition with active flags warrants more scrutiny of hypotheses more explicit uncertainty than a well-mapped one.
Refer to references/red-flags.md for the full set of flags and suggested actions.
Once you understand the user's situation, shift to helping them summarize their understanding of how the evidence landscape relates to the questions they want to bring to their medical team. This phase is more template-driven: explain each section and help them think through it.
Competing hypotheses:
First, determine the user's diagnosis status from Phase 1. This changes how hypotheses are framed:
If the user has an unconfirmed or suspected diagnosis (suggested but not clinically confirmed, or self-identified): Generate at least 3 possible explanations for their symptom picture. Include the condition they're most focused on, at least one more common alternative, and at least one less obvious possibility. For each, note: how well does it explain ALL the symptoms? What doesn't it explain? What would confirm or disconfirm it? This isn't about being right — present it as: "Let's map out the possibilities so we can think about which ones deserve more investigation."
If the user has a confirmed diagnosis (clinically confirmed with objective evidence — test results, imaging, biopsy, specialist assessment): Treat the diagnosis as a known fact. Do not generate competing "maybe it's something else" hypotheses — this is unhelpful and potentially undermining. Instead, reframe the hypotheses section around: What subtypes or variants of this condition might apply? What complications or comorbidities are worth exploring? Are there any symptoms not fully explained by the known diagnosis that warrant separate investigation? This is still hypothesis generation, but anchored to the confirmed diagnosis rather than questioning it.
If diagnosis status is ambiguous (e.g., "my doctor thinks it might be X" or "I was told it could be X"): Treat as unconfirmed and generate full competing hypotheses, noting clearly which diagnosis was suggested and what evidence would confirm or rule it out.
When a user resists considering alternatives: If the user pushes back on competing hypotheses and their diagnosis is unconfirmed, note it once — "I'll keep these alternatives in the artifact as something to discuss with your medical team" — and do not remove them. Do not override the user's priorities, but do not abandon the hypotheses either. If their diagnosis is confirmed, their resistance is appropriate — don't push alternatives.
If the user has a confirmed diagnosis and is asking about a future complication or progression risk: Do not frame hypotheses as competing explanations for current symptoms. Instead, frame them as scenarios: What is the likelihood of progression? What modifiable and non-modifiable risk factors apply to this user? What monitoring or early intervention evidence exists? The hypothesis structure becomes:
This reframing keeps the structured thinking without forcing the user into a differential diagnosis framework that doesn't match their actual question.
Evidence weighting: For each hypothesis, help the user think through:
Explain this in plain language: "Let's think about what makes each possibility more or less likely given what you know."
For scenarios (progression/risk questions), reframe as: How likely is this outcome? What factors increase or decrease that likelihood for me specifically?
Do not:
Evidence quality assessment:
If the user references specific studies, articles, or claims about a condition, help them evaluate using the reference file at references/evidence-hierarchy.md. Key questions to surface:
Keep this accessible. The user is not becoming a researcher — they're learning to ask "how strong is this evidence?" in a structured way.
Question generation and prioritization:
Draft all questions that emerge from the hypotheses, evidence evaluation, and red flags. Then — before writing the artifact — ask the user to pick their top 2-3:
"I've put together [N] questions based on everything we've covered. A standard appointment won't have time for all of them. Which 2-3 feel most important to you right now?"
Present the questions in a numbered list so they can respond by number. Tailor the list to the appointment context gathered in Phase 1 (first visit vs. follow-up, GP vs. specialist). After they pick:
Their selected questions go into My Top Questions in the artifact. All questions go into Full Question Bank.
Red flags are applied immediately after the literature search (end of Phase 2), not at the end of the process. This ensures the flags inform how evidence is framed in Phase 3 rather than being appended as an afterthought.
Consult references/red-flags.md for the full set of 10 epistemic red flags. Based on the user's situation, identify the 1-3 most relevant flags and include them in the output artifact.
The flags are:
How to select flags: Choose based on what you learn during the interview and evidence evaluation. Don't force flags that don't apply. When you surface a flag, explain it in plain language and pair it with the specific suggested action from the reference file.
Framing: These are features of the evidence landscape, not criticisms of anyone's medical care. Frame them as: "Here's something about this diagnostic territory that's worth knowing, and here's a specific question it suggests you could ask."
Generate a structured markdown document with these sections and write it to a file named health-evidence-review-[condition]-[YYYY-MM-DD].md in the current working directory. Do not only render it in the conversation — the file is the deliverable. Adapt section depth based on what the user provided — some sections may be brief if the user didn't have much to share on that dimension.
Template selection: Use "Possible Explanations" for differential diagnosis questions. Use "Possible Scenarios" for confirmed diagnosis with progression/risk questions. Include only the relevant section in the output artifact, not both.
Sources and references: There is a dedicated section near the bottom of the document template to contain all references. Throughout the document, include citations to the reference section so that the patient and clinicians can trace where questions and information came from.
The exact section-by-section template — including the Search Context framing, Evidence Snapshot, source verification note, and closing disclaimer — is in references/output-template.md. Use it verbatim, filling in each bracketed section.
These guardrails apply throughout the conversation, not just in the evidence evaluation phase.
When the user cites a study or article:
references/evidence-hierarchy.md)When the user is drawn to a single explanation:
When evidence is ambiguous or conflicting:
When they encounter alarming information:
When you don't know:
Be clear with the user if they're asking for something outside scope:
Task-oriented, warm, plainspoken. Someone who respects the user enough to give them real tools instead of reassurance. Accompany medical jargon with immediate plain-language translation, but also guide the user in thinking about the weight of evidence. No condescension. No hedging so much that the information becomes useless. Respect the user's intelligence, and center their decision-making.
© DrCatHicks, CC-BY-4.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 6 other files (references) in informed-patient/skills/informed-patient of DrCatHicks/informed-patient.
Open the folder on GitHubat commit 3b8583a
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in DrCatHicks/informed-patient, which our catalogue first saw on October 7, 2026.
Informed Patient 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 |
|---|---|---|---|---|---|---|
| Informed Patient this skillDrCatHicks/informed-patient | 168 | 1 repos | ~9.2k | Automated safety check: Warn | CC-BY-4.0 | |
| Hypothesis Generationspacering-net/codeg | 3.9k | 14 repos | ~3.6k | Automated safety check: Notes | MIT | |
| GitHub Deep Researchbytedance/deer-flow | 84k | 4 repos | ~1.3k | Automated safety check: Pass | MIT | |
| Nature Paper CardYuan1z0825/nature-skills | 47k | 2 repos | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| Content Research Writerweapp-tailwindcss/weapp-tailwindcss | 1.9k | 25 repos | ~3.5k | Automated safety check: Pass | MIT | |
| Peer Reviewspacering-net/codeg | 3.9k | 17 repos | ~5.9k | Automated safety check: Notes | MIT |
spacering-net/codeg
Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.
bytedance/deer-flow
Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.
Yuan1z0825/nature-skills
Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.
weapp-tailwindcss/weapp-tailwindcss
Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.
spacering-net/codeg
Structured manuscript/grant review with checklist-based evaluation.
mvanhorn/last30days-skill
Research what people actually say about any topic in the last 30 days.
Categories
A skill your agent uses when the user explicitly asks to use the informed-patient skill to prepare for a medical appointment, organize symptoms before seeing a doctor, or evaluate the evidence…. Informed Patient is an agent skill from DrCatHicks/informed-patient. Use when the user explicitly asks to use the informed-patient skill to prepare for a medical appointment, organize symptoms before seeing a doctor, or evaluate the evidence behind a diagnosis or treatment.
Informed Patient fits situations like: the user explicitly asks to use the informed-patient skill to prepare for a medical appointment; organize symptoms before seeing a doctor; evaluate the evidence behind a diagnosis; automatically from health questions.
Run `npx skills add DrCatHicks/informed-patient --skill informed-patient -a claude-code`. Or copy the skill folder (informed-patient/skills/informed-patient in DrCatHicks/informed-patient) into .claude/skills/informed-patient in your project. Claude Code loads it when a task matches its description.
Run `npx skills add DrCatHicks/informed-patient --skill informed-patient -a codex`. Or copy the skill folder (informed-patient/skills/informed-patient in DrCatHicks/informed-patient) into .agents/skills/informed-patient 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 DrCatHicks/informed-patient --skill informed-patient -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/informed-patient, .gemini/skills/informed-patient, .github/skills/informed-patient and .opencode/skills/informed-patient in your project.
SKILL.md names no scripts, command-line tools or credentials: Informed Patient is instructions for the agent only.
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.
Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way.
Informed Patient is published under the CC-BY-4.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 9.2k tokens (SKILL.md is roughly 37k 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 16k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Informed Patient: Hypothesis Generation (spacering-net/codeg, 3.9k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars) and Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
DrCatHicks (a GitHub user) maintains it in DrCatHicks/informed-patient, which has 168 GitHub stars. The repository was last updated on October 4, 2026.
Source: DrCatHicks/informed-patient on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.