agentleFS
fmschulzfmschulz/omics-skills/skills/bio-logic/SKILL.md

bio-logic

Skill9 starsChanged 4 months agoMITView on GitHub

Assess a scientific claim, study design, or interpretation against its evidence. Use when testing causal reasoning, finding bias, weighing alternative explanations, or revising hypotheses.

The file

We split this skill into the rules it gives an agent

11 rules. About 0 are common, 10 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈10

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use structured frameworks to evaluate scientific claims, methodology, and evidence strength.

    line 8
  2. Distinctive:

    After each major intermediate result, reflect on what changed, revise hypothesis status, and identify the next discriminating check.

    line 14
  3. Very specific:

    When findings need context, pair this reasoning with a literature-search skill such as /polars-dovmed, then revise hypotheses against the …

    line 15
  4. Distinctive:

    Use this loop for omics projects, unexpected results, exploratory analyses, and any request that asks what results mean.

    line 33
  5. Distinctive:

    Initialize: create at least 5 working hypotheses.

    line 35
  6. Distinctive:

    Build an analysis playbook: search the literature for the inferred organism, virus group, data type, or closest lineage.

    line 36
  7. Distinctive:

    Revise: update each hypothesis as supported, weakened, ruled out, or unresolved.

    line 39
  8. Distinctive:

    Replace: if fewer than 5 active hypotheses remain during exploratory work, add plausible replacements or explicitly state why no additional …

    line 40
  9. Distinctive:

    Use relevant sections based on the review scope.

    line 44
  10. Distinctive:

    Check logical connection between data and conclusion.

    line 80
  11. Distinctive:

    Ensure confidence matches evidence strength.

    line 81

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Bio-Logic: Scientific Reasoning Evaluation

Use structured frameworks to evaluate scientific claims, methodology, and evidence strength.

Instructions

  1. Identify the task (claim assessment, paper critique, study design review, project interpretation, or hypothesis revision).
  2. For project work, maintain a hypothesis register with at least 5 distinct active hypotheses until the project is no longer exploratory.
  3. After each major intermediate result, reflect on what changed, revise hypothesis status, and identify the next discriminating check.
  4. When findings need context, pair this reasoning with a literature-search skill such as /polars-dovmed, then revise hypotheses against the literature.
  5. Select the study-type profile before applying a checklist. Do not grade a computational benchmark, phylogenetic analysis, or evolutionary inference as if it were an intervention trial.
  6. Structure output using the provided format.

Study-Type Profiles

ProfileMain evidence checksRating language
Interventionallocation, controls, adherence, attrition, estimand, harmsGRADE when the review question and evidence synthesis support it
Observational or quasi-experimentalidentification assumptions, temporality, confounding, negative controls, sensitivity analysesrisk-of-bias plus causal-confidence statement
Computational or machine learningdata provenance, leakage, splits, baselines, calibration, external validation, reproducibilitycomputational evidence confidence
Evolutionary or comparative genomicsorthology, taxon/reference sampling, model fit, support, contamination, topology sensitivityphylogenetic/comparative evidence confidence
Descriptive or exploratory omicssampling, measurement, multiple testing, effect sizes, replication, alternative explanationsdescriptive confidence; avoid causal labels

Project Hypothesis Loop

Use this loop for omics projects, unexpected results, exploratory analyses, and any request that asks what results mean.

  1. Initialize: create at least 5 working hypotheses. Include biological mechanisms, technical artifacts, null explanations, sampling/batch effects, and annotation/database artifacts where relevant.
  2. Build an analysis playbook: search the literature for the inferred organism, virus group, data type, or closest lineage. Summarize typical analyses, comparison baselines, markers/features, plots, and outlier criteria used by scientists in that literature.
  3. Reflect: for every major intermediate result or QC gate, state the observation, QC status, strongest interpretation, remaining alternatives, and what evidence would separate them.
  4. Contextualize: compare findings against the playbook and run additional literature searches for central or unexpected findings. Use broad synonym-aware queries and cite DOI/PMCID when available.
  5. Revise: update each hypothesis as supported, weakened, ruled out, or unresolved. Keep ruled-out hypotheses visible with the evidence that changed their status.
  6. Replace: if fewer than 5 active hypotheses remain during exploratory work, add plausible replacements or explicitly state why no additional plausible alternatives exist.

Critique Checklist

Use relevant sections based on the review scope. Skip items not applicable to the study type.

## Methodology
- [ ] Design identifies the causal estimand through randomization or a justified quasi-experimental or natural-experiment strategy
- [ ] Sample size justified (power analysis reported)
- [ ] Randomization/blinding implemented where feasible
- [ ] Confounders identified and controlled
- [ ] Measurements validated and reliable

## Statistics
- [ ] Tests appropriate for data type
- [ ] Assumptions checked
- [ ] Multiple comparisons corrected
- [ ] Effect sizes + CIs reported (not just p-values)
- [ ] Missing data handled appropriately

## Interpretation
- [ ] Conclusions match evidence strength
- [ ] Limitations acknowledged
- [ ] Causal claims require an identified causal design: randomized evidence or
      a justified quasi-experimental/natural-experiment strategy with its
      assumptions and sensitivity checks
- [ ] No cherry-picking or overgeneralization

## Red Flags
- [ ] P-values clustered just below .05
- [ ] Outcomes differ from registration
- [ ] Correlation presented as causation
- [ ] Subgroups analyzed without preregistration

Claim Assessment

  1. Identify claim type (causal, associational, descriptive).
  2. Match evidence to claim type.
  3. Check logical connection between data and conclusion.
  4. Ensure confidence matches evidence strength.

Claim strength ladder:

LanguageRequires
"Demonstrates"Strong evidence under a design that identifies the target claim
"Suggests" / "Indicates"Observational with controlled confounds
"Associated with"Observational, no causal claim
"May" / "Might"Preliminary or hypothesis-generating

Output Format

## Summary
[1-2 sentences: What was studied and main finding]

## Strengths
- [Specific methodological strengths]

## Concerns
### Critical (threaten main conclusions)
- [Issue + why it matters]

### Important (affect interpretation)
- [Issue + why it matters]

### Minor (worth noting)
- [Issue]

## Evidence Rating
[Framework appropriate to the study profile, rating, and justification. Use
GRADE only when it applies to the review question.]

## Bottom Line
[What can/cannot be concluded from this evidence]

Project Reasoning Output Format

## Current Result
[Observed intermediate/final result and QC status]

## Hypothesis Register
| Rank | Hypothesis | Status | Evidence For | Evidence Against | Next Discriminating Check |
|------|------------|--------|--------------|------------------|---------------------------|
| 1 | [Hypothesis] | supported/weakened/ruled out/unresolved | [Evidence] | [Evidence] | [Test] |
| 2 | [Hypothesis] | ... | ... | ... | ... |
| 3 | [Hypothesis] | ... | ... | ... | ... |
| 4 | [Hypothesis] | ... | ... | ... | ... |
| 5 | [Hypothesis] | ... | ... | ... | ... |

## Literature Context
- [Paper or search result, DOI/PMCID if available]: supports/contradicts/narrows [hypothesis] because [reason].

## Analysis Playbook
- [Literature-derived analysis/comparison/outlier check and why it applies]

## Revision
[What changed since the previous register and why]

## Next Step
[Most informative analysis, control, or experiment]

Quick Reference

TaskAction
Review a paperUse the Critique Checklist above
Evaluate a claimUse the Claim Assessment steps above
Assess evidence strengthSee references/evidence.md
Identify biasesSee references/biases.md
Statistical errorsSee references/stats.md
Logical fallaciesSee references/fallacies.md
Study design reviewSee references/design.md

Input Requirements

  • Manuscript or study summary
  • Claim statements to evaluate
  • Methods and results (as available)

Output

  • Structured critique with strengths, concerns, and evidence rating
  • Clear recommendation on claim strength and limitations

Quality Gates

  • Claim type matches evidence type
  • Key methodological risks are identified
  • Evidence rating is justified with concrete issues
  • The evidence framework matches the study type; computational and evolutionary work is not forced into intervention-centric GRADE rules
  • Exploratory project work includes at least 5 active hypotheses or explains why fewer are plausible
  • Discovery work includes a literature-derived analysis playbook before selecting analyses
  • Intermediate results update hypothesis status before the next workflow step
  • Central or unexpected findings are checked against the literature before final interpretation

Examples

Example 1: Quick Paper Critique

Input: "Review this RCT on vitamin D and depression"

Output:

## Summary
RCT of 200 adults testing vitamin D supplementation for depression over 12 weeks.

## Strengths
- Randomized, double-blind, placebo-controlled
- Validated depression scale (PHQ-9)
- Adequate power analysis

## Concerns
### Critical
- 35% dropout, differential by group (attrition bias)
- ITT analysis not performed

### Important
- Single-site limits generalizability

## Evidence Rating
Moderate (downgraded from high due to attrition bias)

## Bottom Line
Suggestive but not conclusive due to differential attrition.

Example 2: Claim Assessment

Input: "This study proves that coffee prevents Alzheimer's"

Assessment: If based only on an association with no identified causal design, this is a correlation→causation error. Appropriate language: "Coffee consumption is associated with lower Alzheimer's risk." Observational data with a justified quasi-experimental or natural-experiment strategy, its assumptions stated and tested, can support a causal claim; the design is what decides, not whether the data were observational.

Troubleshooting

Issue: Insufficient methods details Solution: Request missing design/statistics information before rating evidence.

Issue: Conflicting results across studies Solution: Report uncertainty and suggest stronger study designs for resolution.

Related Skills

  • /ai-scientist-evaluator: rubric-scored evaluation of AI scientist outputs
  • /manuscript-review-council: multi-reviewer critique of peer-reviewed manuscripts
  • /proposal-review: structured critique of funding proposals

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.