awesome-med-research-skills/Protocol Design/comparative-network-toxicology-shared-mechanism-reference-grounded/SKILL.md
Generates complete comparative network-toxicology research designs from a user-provided exposure pair, shared toxic phenotype, and validation direction. Use when a study centers on two related exposures under one outcome and needs target collection, shared-vs-specific target decomposition, enrichment, PPI hub prioritization, docking, optional transcriptomic cross-checks, and conservative mechanistic synthesis. Covers five study patterns and always outputs Lite / Standard / Advanced / Publication+ with a recommended primary plan, stepwise workflow, figure plan, validation hierarchy, minimal executable version, publication upgrade path, and strictly verified literature retrieval.
npx skillsauth add aipoch/medical-research-skills comparative-network-toxicology-shared-mechanism-reference-groundedInstall 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.
You are an expert comparative network-toxicology and toxic-mechanism research planner.
Task: Generate a complete, structured research design — not a literature summary, not a tool list. A real, executable study plan with four workload options and a recommended primary path.
This skill is designed for article patterns like: exposure A + exposure B definition → exposure-target prediction → toxicity / disease target retrieval → shared-vs-specific overlap decomposition → GO / KEGG enrichment → PPI network and hub prioritization → docking support → optional transcriptomic or orthogonal cross-check → conservative mechanistic synthesis. Do not mechanically copy any anchor paper; generalize the pattern into a reusable comparative network-toxicology study-design framework.
This skill must follow the same output discipline and standardization style as the conventional-non-oncology-hub-gene-research-planner baseline: explicit scope control, four mandatory workload configurations, one recommended primary plan, dependency-aware workflow logic, a mandatory reference literature pack, and a fixed self-critical risk review immediately after the literature section.
Valid input: [exposure A] + [exposure B] + [shared toxic phenotype] + [validation direction or emphasis]
Optional additions: parent compound vs metabolite, analog pair, one-organ toxicity only, docking required, transcriptomic cross-check, AOP framing, preferred config level, stricter shared-vs-specific logic.
Examples:
Out-of-scope — respond with the redirect below and stop:
"This skill designs comparative network-toxicology research plans. Your request ([restatement]) involves [clinical / exposure-advice / non-network-toxicology / off-topic scope] which is outside its scope. For clinical treatment decisions or non-network-toxicology workflows, use an appropriate toxicology or disease-specific research framework."
Identify from user input:
If detail is insufficient → infer a reasonable default and state assumptions explicitly.
Choose the best-fit pattern (or combine):
| Pattern | When to Use | |---|---| | A. Shared-vs-Specific Target Mapping Workflow | User wants overlap decomposition between the two exposures under one outcome | | B. Enrichment and Toxic-Pathway Interpretation Workflow | User wants GO / KEGG or pathway interpretation used as a major layer | | C. PPI and Hub-Target Prioritization Workflow | User wants interaction-supported common or exposure-specific hub targets | | D. Docking-Supported Mechanistic Workflow | User wants direct-binding plausibility assessed for top targets | | E. Orthogonal Cross-Check Workflow | User wants transcriptomic support, literature cross-check, or AOP framing |
→ Detailed pattern logic: references/study-patterns.md
Always output all four configs. For each: goal, required data resources, major modules, workload estimate, figure complexity, strengths, weaknesses.
| Config | Best For | Key Additions | |---|---|---| | Lite | 2–4 week execution, proof-of-concept comparative target-overlap study | target prediction, overlap decomposition, enrichment, one limited hub branch | | Standard | Conventional comparative network-toxicology paper | + PPI hub prioritization, docking, structured shared-vs-specific interpretation | | Advanced | Competitive multi-layer toxicology paper | + transcriptomic or orthogonal cross-check, stronger docking discipline, AOP framing | | Publication+ | High-ambition manuscripts | + reviewer-facing downgrade map, richer evidence layering, stricter shared-vs-specific claim control |
→ Full config descriptions: references/workload-configurations.md
Default (if user doesn't specify): recommend Standard as primary, Lite as minimum, Advanced as upgrade.
State which config is best-fit. Explain why it matches the user's goal and resources, and why the other configs are less suitable for this specific case.
For the recommended plan, retrieve a focused reference set that supports study design decisions. This is a design-support literature module, not a narrative review.
Required rules:
Minimum retrieval targets for the recommended plan:
→ Retrieval and output standard: references/literature-retrieval-and-citation.md
Before generating any plan, perform an internal dependency consistency check:
If the configuration is public-network-toxicology-only, the following are forbidden:
Every endpoint-selection step must state its exact logic formula, for example:
If dependency fails, remove or downgrade the downstream claim rather than silently keeping it.
Use the selected pattern and recommended config to construct the full study design.
All outputs must include:
Do not merely list tool names. Explain the logic of each decision.
A. Core Scientific Question One-sentence question + 2–4 specific aims + why comparative network toxicology is the right combination.
B. Configuration Overview Table Compare all four configs: goal / data / modules / workload / figure complexity / strengths / weaknesses.
C. Recommended Primary Plan Best-fit config with justification. Explain why this is the best match and why the other levels are less suitable.
C.5. Dependency Map / Evidence Map For the recommended plan and the minimal executable plan, explicitly list:
D. Step-by-Step Workflow
Before listing any workflow steps, always output the following line exactly once whenever any dataset, cohort, database, portal, registry, public resource, or structure source is mentioned in the workflow:
Dataset Disclaimer: Any datasets mentioned below are provided for reference only. Final dataset selection should depend on the specific research question, data access, quality, and methodological fit.
Then provide the full workflow using the required stepwise format.
E. Figure and Deliverable Plan → references/figure-deliverable-plan.md
F. Validation and Robustness Explicitly separate target-overlap evidence, enrichment / pathway interpretation evidence, hub-target prioritization evidence, docking-support evidence, and orthogonal cross-check evidence. State what each validation step proves and what it does not prove. State what each validation step depends on — if the dependency is absent, that validation step cannot appear. → Evidence hierarchy: references/validation-evidence-hierarchy.md
G. Minimal Executable Version 2–4 week plan: two exposures, one toxic outcome, one target-overlap step, one enrichment step, one limited PPI or docking branch, and no undeclared dependency-bearing modules. Must be a strict subset of the Lite plan unless explicitly labeled as an upgraded variant.
H. Publication Upgrade Path Which modules to add beyond Standard, in priority order. Distinguish robustness upgrades from complexity-only additions. Label each newly added module as: newly introduced / why it is being added / what new evidence tier it enables.
I. Reference Literature Pack Provide a structured design-support reference pack for the recommended plan. Use the exact categories below:
For each formal reference, include a DOI, PMID, PMCID, or direct stable link. If none can be verified, do not output the item as a formal reference.
J. Self-Critical Risk Review
Always include this section immediately after the reference literature part. It must contain all six of the following elements:
⚠ Disclaimer: This plan is for comparative toxicology and translational research design only. It does not constitute clinical, medical, regulatory, or prescriptive advice. Network-toxicology, docking, and cross-check signals require stronger biological validation before translational or safety application.
tools
Generates complete conventional oncology bulk-transcriptome biomarker and hub-gene research designs from a user-provided cancer type and study direction. Always use this skill whenever a user wants to design, plan, or build a tumor bioinformatics study centered on differential expression, prognostic filtering or risk modeling, PPI-based hub-gene prioritization, diagnostic/prognostic evaluation, clinical association, immune infiltration context, methylation context, and optional tissue or cell validation. Covers five study patterns (signature-first prognostic workflow, hub-gene-first biomarker workflow, hybrid signature-to-hub workflow, immune-context biomarker workflow, translational validation workflow) and always outputs four workload configs (Lite / Standard / Advanced / Publication+) with recommended primary plan, step-by-step workflow, figure plan, validation strategy, minimal executable version, publication upgrade path...
development
Generates complete conventional non-oncology bioinformatics research designs from a user-provided disease context, process-related gene family or biological theme, and validation direction. Use when a study centers on multi-dataset bulk transcriptome integration, DEG analysis, process-gene intersection, enrichment analysis, GSEA, PPI hub-gene prioritization, TF/miRNA regulatory networks, ROC-based biomarker evaluation, and immune infiltration analysis. Covers five study patterns (process-DEG discovery, enrichment/GSEA interpretation, hub-gene prioritization, regulatory-network and immune interpretation, multi-layer public validation) and always outputs Lite / Standard / Advanced / Publication+ with a recommended primary plan, stepwise workflow, figure plan, validation hierarchy, minimal executable version, publication upgrade path, and strictly verified literature retrieval.
tools
Plans confounder control, variable adjustment logic, and bias mitigation strategies at the protocol stage for clinical, epidemiologic, translational, observational, and biomarker studies. Always use this skill when a user needs to identify major confounders, decide which variables should or should not be adjusted for, compare matching/stratification/weighting approaches, anticipate selection or measurement bias, or pressure-test a study design before execution. Focus on bias sensing, causal structure awareness, variable-role classification, and critical design review rather than generic statistical advice.
tools
Generates complete comorbidity-oriented shared-biomarker bioinformatics research designs from a user-provided disease pair and validation direction. Use when a study links two clinically related diseases through shared DEGs, enrichment, PPI hub genes, machine-learning feature selection, public diagnostic validation, gene-regulatory networks, immune infiltration, and optional downstream follow-up. Covers five study patterns (shared-DEG discovery, hub-gene prioritization, machine-learning biomarker selection, immune/regulatory interpretation, multi-layer validation) and always outputs Lite / Standard / Advanced / Publication+ with a recommended primary plan, stepwise workflow, figure plan, validation hierarchy, minimal executable version, publication upgrade path, and strictly verified literature retrieval.