Source: https://github.com/aipoch/medical-research-skills
Basic Research Topic Design
This skill helps users design a biomedical research topic by generating progressive subtitles and a detailed experimental outline.
When to Use
- Use this skill when the request matches its documented task boundary.
- Use it when the user can provide the required inputs and expects a structured deliverable.
- Prefer this skill for repeatable, checklist-driven execution rather than open-ended brainstorming.
Key Features
- Scope-focused workflow aligned to: A biomedical research topic designer that generates progressive experimental subtitles and detailed research outlines based on a given subject. Use when the user wants to design a research proposal, outline experiments for a topic, or structure a biomedical study.
- Documentation-first workflow with no packaged script requirement.
- Reference material available in
references/ for task-specific guidance.
- Structured execution path designed to keep outputs consistent and reviewable.
Dependencies
Python: 3.10+. Repository baseline for current packaged skills.
Third-party packages: not explicitly version-pinned in this skill package. Add pinned versions if this skill needs stricter environment control.
Example Usage
Skill directory: 20260316/scientific-skills/Protocol Design/basic-research-design
No packaged executable script was detected.
Use the documented workflow in SKILL.md together with the references/assets in this folder.
Example run plan:
- Read the skill instructions and collect the required inputs.
- Follow the documented workflow exactly.
- Use packaged references/assets from this folder when the task needs templates or rules.
- Return a structured result tied to the requested deliverable.
Implementation Details
See ## Workflow above for related details.
- Execution model: validate the request, choose the packaged workflow, and produce a bounded deliverable.
- Input controls: confirm the source files, scope limits, output format, and acceptance criteria before running any script.
- Primary implementation surface: instruction-only workflow in
SKILL.md.
- Reference guidance:
references/ contains supporting rules, prompts, or checklists.
- Parameters to clarify first: input path, output path, scope filters, thresholds, and any domain-specific constraints.
- Output discipline: keep results reproducible, identify assumptions explicitly, and avoid undocumented side effects.
Workflow
Follow these steps to generate the research design.
Step 1: Generate Subtitles
- Identify the Subject (keywords) from the user's request (e.g., "PD-1 in lung cancer").
- Use the Subtitle Generation Prompt (see
references/prompt_templates.md) to generate 6 progressive subtitles.
- Input for Prompt:
<Subject>: The user's subject.
Step 2: Generate Research Outline
- Take the Subject and the Subtitles generated in Step 1.
- Use the Research Outline Generation Prompt (see
references/prompt_templates.md) to generate the detailed outline.
- Input for Prompt:
<Subject>: The original subject.
<Subtitles>: The output from Step 1.
Quality Rules
- Progressive Logic: Ensure the subtitles and experiments show a clear logical progression (screening -> verification -> mechanism -> in vivo).
- Specific Methods: The outline must include specific experimental method names.
- No Summary: Do not output a summary at the end.
- Exact Count: Ensure exactly 6 subtitles are generated in Step 1.
Output Format
Present the final result in Markdown, following the format specified in the prompt templates.
When Not to Use
- Do not use this skill when the required source data, identifiers, files, or credentials are missing.
- Do not use this skill when the user asks for fabricated results, unsupported claims, or out-of-scope conclusions.
- Do not use this skill when a simpler direct answer is more appropriate than the documented workflow.
Required Inputs
- A clearly specified task goal aligned with the documented scope.
- All required files, identifiers, parameters, or environment variables before execution.
- Any domain constraints, formatting requirements, and expected output destination if applicable.
Output Contract
- Return a structured deliverable that is directly usable without reformatting.
- If a file is produced, prefer a deterministic output name such as
basic_research_design_result.md unless the skill documentation defines a better convention.
- Include a short validation summary describing what was checked, what assumptions were made, and any remaining limitations.
Validation and Safety Rules
- Validate required inputs before execution and stop early when mandatory fields or files are missing.
- Do not fabricate measurements, references, findings, or conclusions that are not supported by the provided source material.
- Emit a clear warning when credentials, privacy constraints, safety boundaries, or unsupported requests affect the result.
- Keep the output safe, reproducible, and within the documented scope at all times.
Failure Handling
- If validation fails, explain the exact missing field, file, or parameter and show the minimum fix required.
- If an external dependency or script fails, surface the command path, likely cause, and the next recovery step.
- If partial output is returned, label it clearly and identify which checks could not be completed.
Input Validation
This skill accepts requests that match the documented purpose of basic-research-design and include enough context to complete the workflow safely.
Do not continue the workflow when the request is out of scope, missing a critical input, or would require unsupported assumptions. Instead respond:
basic-research-design only handles its documented workflow. Please provide the missing required inputs or switch to a more suitable skill.
Quick Validation
Run this minimal verification path before full execution when possible:
No local script validation step is required for this skill.
Expected output format:
Result file: basic_research_design_result.md
Validation summary: PASS/FAIL with brief notes
Assumptions: explicit list if any
1---2name: basic-research-design3description: A biomedical research topic designer that generates progressive experimental subtitles and detailed research outlines based on a given subject. Use when the user wants to design a research proposal, outline experiments for a topic, or structure a biomedical study.4license: MIT5---6> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)
7
8# Basic Research Topic Design
9
10This skill helps users design a biomedical research topic by generating progressive subtitles and a detailed experimental outline.
11
12## When to Use
13
14- Use this skill when the request matches its documented task boundary.
15- Use it when the user can provide the required inputs and expects a structured deliverable.
16- Prefer this skill for repeatable, checklist-driven execution rather than open-ended brainstorming.
17
18## Key Features
19
20- Scope-focused workflow aligned to: A biomedical research topic designer that generates progressive experimental subtitles and detailed research outlines based on a given subject. Use when the user wants to design a research proposal, outline experiments for a topic, or structure a biomedical study.
21- Documentation-first workflow with no packaged script requirement.
22- Reference material available in `references/` for task-specific guidance.
23- Structured execution path designed to keep outputs consistent and reviewable.
24
25## Dependencies
26
27- `Python`: `3.10+`. Repository baseline for current packaged skills.
28- `Third-party packages`: `not explicitly version-pinned in this skill package`. Add pinned versions if this skill needs stricter environment control.
29
30## Example Usage
31
32```text
33Skill directory: 20260316/scientific-skills/Protocol Design/basic-research-design
34No packaged executable script was detected.
35Use the documented workflow in SKILL.md together with the references/assets in this folder.
36```
37
38Example run plan:
391. Read the skill instructions and collect the required inputs.
402. Follow the documented workflow exactly.
413. Use packaged references/assets from this folder when the task needs templates or rules.
424. Return a structured result tied to the requested deliverable.
43
44## Implementation Details
45
46See `## Workflow` above for related details.
47
48- Execution model: validate the request, choose the packaged workflow, and produce a bounded deliverable.
49- Input controls: confirm the source files, scope limits, output format, and acceptance criteria before running any script.
50- Primary implementation surface: instruction-only workflow in `SKILL.md`.
51- Reference guidance: `references/` contains supporting rules, prompts, or checklists.
52- Parameters to clarify first: input path, output path, scope filters, thresholds, and any domain-specific constraints.
53- Output discipline: keep results reproducible, identify assumptions explicitly, and avoid undocumented side effects.
54
55## Workflow
56
57Follow these steps to generate the research design.
58
59### Step 1: Generate Subtitles
60
611. Identify the **Subject** (keywords) from the user's request (e.g., "PD-1 in lung cancer").
622. Use the **Subtitle Generation Prompt** (see `references/prompt_templates.md`) to generate 6 progressive subtitles.
633. **Input for Prompt**:
64 * `<Subject>`: The user's subject.
65
66### Step 2: Generate Research Outline
67
681. Take the **Subject** and the **Subtitles** generated in Step 1.
692. Use the **Research Outline Generation Prompt** (see `references/prompt_templates.md`) to generate the detailed outline.
703. **Input for Prompt**:
71 * `<Subject>`: The original subject.
72 * `<Subtitles>`: The output from Step 1.
73
74### Quality Rules
75
76* **Progressive Logic**: Ensure the subtitles and experiments show a clear logical progression (screening -> verification -> mechanism -> in vivo).
77* **Specific Methods**: The outline must include specific experimental method names.
78* **No Summary**: Do not output a summary at the end.
79* **Exact Count**: Ensure exactly 6 subtitles are generated in Step 1.
80
81## Output Format
82
83Present the final result in Markdown, following the format specified in the prompt templates.
84
85## When Not to Use
86
87- Do not use this skill when the required source data, identifiers, files, or credentials are missing.
88- Do not use this skill when the user asks for fabricated results, unsupported claims, or out-of-scope conclusions.
89- Do not use this skill when a simpler direct answer is more appropriate than the documented workflow.
90
91## Required Inputs
92
93- A clearly specified task goal aligned with the documented scope.
94- All required files, identifiers, parameters, or environment variables before execution.
95- Any domain constraints, formatting requirements, and expected output destination if applicable.
96
97## Output Contract
98
99- Return a structured deliverable that is directly usable without reformatting.
100- If a file is produced, prefer a deterministic output name such as `basic_research_design_result.md` unless the skill documentation defines a better convention.
101- Include a short validation summary describing what was checked, what assumptions were made, and any remaining limitations.
102
103## Validation and Safety Rules
104
105- Validate required inputs before execution and stop early when mandatory fields or files are missing.
106- Do not fabricate measurements, references, findings, or conclusions that are not supported by the provided source material.
107- Emit a clear warning when credentials, privacy constraints, safety boundaries, or unsupported requests affect the result.
108- Keep the output safe, reproducible, and within the documented scope at all times.
109
110## Failure Handling
111
112- If validation fails, explain the exact missing field, file, or parameter and show the minimum fix required.
113- If an external dependency or script fails, surface the command path, likely cause, and the next recovery step.
114- If partial output is returned, label it clearly and identify which checks could not be completed.
115
116
117## Input Validation
118
119This skill accepts requests that match the documented purpose of `basic-research-design` and include enough context to complete the workflow safely.
120
121Do not continue the workflow when the request is out of scope, missing a critical input, or would require unsupported assumptions. Instead respond:
122
123> `basic-research-design` only handles its documented workflow. Please provide the missing required inputs or switch to a more suitable skill.
124
125## Quick Validation
126
127Run this minimal verification path before full execution when possible:
128
129```text
130No local script validation step is required for this skill.
131```
132
133Expected output format:
134
135```text
136Result file: basic_research_design_result.md
137Validation summary: PASS/FAIL with brief notes
138Assumptions: explicit list if any
139```