Skills Agentes

Hypothesis Generation

Formula preguntas científicas acotadas por evidencia, hipótesis candidatas, explicaciones rivales, afirmaciones causales o asociativas, predicciones discriminantes y planes de análisis listos para preregistro.

Estrellas
34.8k

en todo el repo

Actividad
61

0–100, la ruta de este skill

Actualizado
el mes pasado

último commit aquí

Commits
6

últimos 90 días

Contexto
3.7k tok

85 tok en reposo

Paquete
27 archivos

249 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add K-Dense-AI/scientific-agent-skills --skill hypothesis-generation --agent claude-code

Se instala solo en este repositorio.

Este skill makes network requests.

Qué hace

  • Guía el flujo desde una observación hasta hipótesis rivales, predicciones discriminantes y un plan de análisis preregistrable
  • Distingue objetos que no deben confundirse (observación, hipótesis, mecanismo, predicción, evidencia, control negativo...)
  • Aplica una puerta de alcance y seguridad antes de tocar datos sensibles, no publicados o regulados
  • Ofrece CLIs locales deterministas para validar esquemas de hipótesis, matrices de predicción y ledgers de evidencia
  • Previene el HARKing exigiendo registrar el plan antes de acceder a los resultados objetivo

Úsalo cuando

  • Necesitas convertir una observación u hallazgo preliminar en hipótesis candidatas y predicciones testeables
  • Vas a diseñar un plan de análisis preregistrado o distinguir hipótesis confirmatorias de exploratorias
  • Necesitas generar explicaciones rivales (confusión, sesgo de selección, causalidad inversa...) antes de elegir una prueba

No lo uses cuando

    Qué lo activa

    Di cualquiera de estas frases y el agente debería cargar este skill.

    • Ayúdame a generar hipótesis rivales para esta observación
    • Diseña un plan de preregistro para este hallazgo preliminar
    • Deriva predicciones que discriminen entre estas hipótesis

    SKILL.md

    En inglés

    Scientific Hypothesis Generation

    Turn an observation into a transparent set of candidate explanations and tests. A hypothesis is a proposal to be challenged, not a finding, fact, diagnosis, or recommendation.

    Non-negotiable boundaries

    Before using unpublished, sensitive, controlled, personal, proprietary, export-controlled, or security-relevant material:

    1. Confirm authorization and the applicable institutional, funder, publisher, data-use, privacy, and AI policies.
    2. Keep the material local unless an authorized human explicitly approves a named external destination and data scope.
    3. Minimize inputs. Do not place sensitive or unpublished data in web searches or external AI systems without authorization.
    4. Stop at the appropriate human, animal, biosafety, dual-use, data-governance, or regulatory gate.

    Never:

    • present a hypothesis, mechanism, causal effect, citation, or apparent pattern as established evidence;
    • claim novelty because a quick search found nothing;
    • infer causation from association, temporal order alone, predictive accuracy, or model output;
    • supply patient-specific diagnosis, treatment, dose, prognosis, or other clinical advice;
    • provide harmful experimental optimization or operational detail for pathogens, toxins, weapons, evasion, or other misuse;
    • bypass IRB/REC, IACUC, IBC, biosafety, dual-use, privacy, legal, or regulatory review;
    • fabricate sources, identifiers, search coverage, data, results, approvals, or preregistration;
    • automatically score, rank, select, accept, or reject scientific hypotheses.

    If a request crosses a safety gate, produce only a high-level risk/oversight note and route it to the qualified local authority. Do not continue with operational detail.

    Keep the objects distinct

    Object Meaning
    Observation What was measured, noticed, or reported, with provenance and uncertainty
    Research question The answerable question that defines scope
    Hypothesis A candidate explanatory or relational proposition
    Mechanism The proposed process connecting conditions to an outcome
    Causal estimand The precisely defined causal contrast to estimate
    Prediction An observable implication derived before checking the target result
    Alternative explanation A rival account, including bias or non-causal explanations
    Null hypothesis A specified no-effect/no-difference model used by an analysis
    Negative control A control expected not to operate through the proposed mechanism
    Operationalization How a construct becomes a variable, measurement, intervention, or category
    Analysis plan Prespecified transformations, models, contrasts, uncertainty, and decision rules
    Evidence Observations or sources that bear on a claim; never the claim itself

    Do not collapse these labels. A mechanistic story is not a prediction; a prediction is not evidence; rejection of one null does not prove a mechanism; support for one candidate does not eliminate unconsidered rivals.

    Workflow

    1. Run the scope and safety gate

    Record:

    • accountable human owner and intended use;
    • data sensitivity, authorization, retention, and permitted processing;
    • affected people, animals, ecosystems, communities, or security interests;
    • required ethics, feasibility, biosafety, dual-use, and regulatory reviews;
    • unresolved blocks and domain expertise needed.

    No script approval is an ethics, safety, regulatory, or scientific approval.

    2. Freeze the observation

    Write the observation before interpretation:

    • measurement or source;
    • population, system, place, and time;
    • unit of observation and unit of analysis;
    • uncertainty, missingness, exclusions, and preprocessing;
    • whether the pattern was expected, exploratory, or selected after viewing results.

    Use “reported,” “observed,” or “associated,” not causal language, unless a causal design and estimand justify it.

    3. Frame the research question

    Choose a framework only when it fits:

    • PICO/PICOT for intervention/effectiveness questions: population, intervention, comparator, outcome, and optionally time.
    • PECO for exposure questions.
    • Population–index test–reference standard–target condition for diagnostic accuracy.
    • Population–prognostic factor–outcome–time for prognosis.
    • A domain-specific construct–context–outcome frame for qualitative, descriptive, mechanistic, or theoretical work.

    PICO is not a universal template. Define stakeholders, context, boundaries, feasibility, and what answer would change knowledge or practice. FINER is a question-refinement mnemonic—Feasible, Interesting, Novel, Ethical, Relevant—not a scoring system. Treat “Novel” as unresolved until a documented, fit-for-purpose search and expert review support it.

    4. Establish a dated evidence boundary

    Search before making literature-dependent statements. Prefer primary research, official policies, primary methods papers, current reporting guidelines, and systematic reviews used for orientation.

    Record:

    • search date and cutoff;
    • databases/indexes, queries, filters, and screening boundary;
    • included and excluded source types;
    • sources supporting, challenging, or contextualizing each claim;
    • known access, language, database, and time limitations.

    A search can establish what was searched, not universal absence. Say “not located within the documented search boundary,” never “no prior work exists.” Use assets/search_boundary_template.json, assets/evidence_ledger_template.csv, and references/literature_search_strategies.md.

    5. Generate rivals before choosing tests

    Create multiple candidates from genuinely different explanatory classes when plausible:

    • proposed mechanism;
    • measurement or processing artifact;
    • confounding or common cause;
    • selection or attrition;
    • conditioning on a collider;
    • reverse causation;
    • temporal, contextual, or boundary-condition differences;
    • stochastic variation;
    • competing mechanisms at another scale.

    Generate an initial rival set independently before AI-assisted expansion to reduce anchoring and homogenization. Do not force a fixed number or false symmetry. Keep every candidate labeled candidate.

    Platt’s strong-inference pattern motivates alternative hypotheses and crucial tests, but failed alternatives do not make the survivor true. Unknown alternatives, auxiliary assumptions, measurement error, and mixed mechanisms remain possible.

    6. Declare the claim type and estimand

    Classify each target as:

    • descriptive;
    • associational;
    • predictive;
    • causal;
    • mechanistic.

    For a causal target, define before analysis:

    • target population or system;
    • intervention/exposure and comparator;
    • outcome and time horizon;
    • population-level summary;
    • treatment versions and intercurrent-event handling where relevant;
    • identification assumptions and target-trial/design analogue.

    Document confounding, selection, collider, measurement, and reverse-causation risks separately. An observational causal estimate remains assumption-dependent. Use references/causal_inference_and_claims.md.

    7. Derive discriminating predictions

    For every candidate:

    1. State conditions and boundary conditions.
    2. Name the observable and measurement.
    3. State the expected pattern and uncertainty.
    4. State a result incompatible with the candidate under declared assumptions.
    5. Contrast the expected result with at least one rival.
    6. Define indeterminate outcomes and what would be learned from them.

    Prefer tests where rivals predict meaningfully different outcomes. Add positive, procedural, and negative controls when scientifically appropriate. A negative control must be incapable of operating through the target mechanism while sharing relevant bias pathways; it is not a decorative untreated group.

    Use assets/prediction_rival_matrix_template.csv and assets/falsification_controls_template.json.

    8. Operationalize and validate measurement

    For every construct record:

    • variable role and operational definition;
    • population/system, unit, timing, and conditions;
    • instrument/method, calibration, quality control, and masking;
    • reliability/repeatability;
    • validity evidence and applicability;
    • missingness, detection limits, transformations, cut points, and their rationales;
    • measurement invariance or cross-group comparability when relevant;
    • foreseeable measurement bias and limitations.

    Do not treat a convenient proxy as the construct itself. Validate with:

    python3 scripts/check_operationalization.py local-operationalization.json
    

    9. Match design and analysis to the claim

    Specify:

    • sampling, experimental unit, allocation, randomization, masking, and controls;
    • inclusion/exclusion and stopping rules;
    • sample-size, precision, or information rationale based on declared assumptions;
    • outcomes, contrasts, estimands, models, effect measures, and uncertainty;
    • missing-data and intercurrent-event handling;
    • multiplicity across outcomes, models, subgroups, looks, and hypotheses;
    • assumptions, diagnostics, robustness, and sensitivity analyses;
    • replication or independent validation plan;
    • what is confirmatory versus exploratory.

    Do not use universal sample-size minima. Do not interpret a thresholded p-value as the probability a hypothesis is true or as effect importance. See references/experimental_design_patterns.md.

    For intervention trials, use the current SPIRIT 2025 protocol guidance and CONSORT 2025 reporting guidance where applicable. These improve completeness; they do not certify design quality, ethics, or regulatory compliance.

    10. Prevent HARKing and expose deviations

    Before accessing the target outcomes, timestamp the question, candidates, predictions, outcomes, exclusions, transformations, analysis, multiplicity, missing-data plan, and stopping rule when feasible.

    Afterward:

    • label data-dependent ideas and analyses exploratory;
    • preserve and report planned analyses;
    • list deviations with date, rationale, who decided, and expected impact;
    • never rewrite an observed pattern as an a priori prediction.

    Preregistration is a transparent plan, not a ban on adaptation. Registered Reports add results-blind peer review and in-principle acceptance under journal policy. See references/preregistration_and_open_science.md.

    11. Plan replication and updating

    Distinguish:

    • reproducibility: consistent computational results from the same data/code/conditions;
    • replicability: consistency across studies collecting new data for the same question.

    Preserve provenance, versions, code, materials, and decision logs when sharing is authorized. Plan independent replication or transport tests across relevant boundaries. Update candidate status when contrary, null, or replication evidence arrives; do not hide negative results.

    12. Apply human accountability

    The accountable human must verify:

    • every citation and source-to-claim link;
    • domain plausibility and measurement validity;
    • causal assumptions and statistical design;
    • ethics, feasibility, safety, privacy, and regulatory status;
    • all AI-assisted text, ideas, and citations;
    • whether broader expertise or community input is required.

    AI can confabulate citations, anchor reasoning, and homogenize candidate sets. Record permitted AI use and material influence. Keep independent human ideation and rival generation in the process.

    Local tool index

    All CLIs are bounded, dependency-free, local, deterministic, and non-scoring:

    Task Asset Command
    Hypothesis-record schema assets/hypothesis_record_template.json python3 scripts/validate_hypothesis_schema.py record.json
    Measurement checklist assets/operationalization_template.json python3 scripts/check_operationalization.py checklist.json
    Prediction/rival matrix assets/prediction_rival_matrix_template.csv python3 scripts/validate_prediction_matrix.py matrix.csv
    Claim-language lint Annotated Markdown python3 scripts/lint_causal_claims.py draft.md
    Falsification/controls assets/falsification_controls_template.json python3 scripts/check_falsification_controls.py controls.json
    Evidence/source audit assets/evidence_ledger_template.csv + assets/search_boundary_template.json python3 scripts/audit_evidence_ledger.py ledger.csv boundary.json
    Preregistration scaffold assets/preregistration_scaffold_template.md python3 scripts/generate_preregistration_scaffold.py record.json -o preregistration.md

    Exit codes are 0 for structurally valid output, 1 for completed validation with errors, and 2 for malformed/unsafe input. Reports validate declarations and internal consistency only; they do not verify scientific truth or choose a hypothesis. Full schemas are in references/tool_reference.md.

    References

    • references/concepts_and_workflow.md — object model, strong inference, uncertainty, and candidate lifecycle
    • references/hypothesis_quality_criteria.md — non-scoring human review criteria
    • references/literature_search_strategies.md — traceable, bounded evidence search
    • references/causal_inference_and_claims.md — estimands and causal-bias risks
    • references/experimental_design_patterns.md — design, controls, measurement, multiplicity, and replication
    • references/preregistration_and_open_science.md — preregistration, Registered Reports, deviations, and open science
    • references/ethics_safety_and_ai.md — oversight gates, dual use, data handling, and responsible AI
    • references/tool_reference.md — CLI schemas, limits, and examples
    • references/source_ledger.md — dated authoritative source notes
    • references/security_validation.md — baseline findings and validation record

    The bundled source ledger is assets/source_ledger.csv, verified through 2026-07-23. Recheck time-sensitive policy and guidance before a later or jurisdiction-specific use.

    Reproducido de K-Dense-AI/scientific-agent-skills bajo licencia MIT. Leer esta página en markdown.

    Archivos

    27 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

    Antes de instalar

    Requiere Python 3.11+ de la librería estándar; las CLIs incluidas son deterministas, locales y no necesitan red, credenciales ni modelos.

    Necesita en el PATH:python3

    Detalles

    Creador
    K-Dense-AI
    Categoría
    Investigación
    Licencia
    MIT
    Recursos incluidos
    scripts en python + referencias
    Código fuente
    Ver SKILL.md

    Etiquetas

    Más de K-Dense-AI/scientific-agent-skills

    Este repo incluye 163 skills. Si instalas uno, normalmente ya tienes los demás.

    Gestión integral de citas académicas: busca en OpenAlex, PubMed y Google Scholar, extrae metadatos precisos, valida citas y genera entradas BibTeX correctamente formateadas.

    Costo de contexto al activarse
    3.7k tok
    Tamaño del paquete
    21 archivos
    Última actualización
    hace 28 días
    investigacion

    Realiza revisiones bibliográficas sistemáticas y completas usando varias bases académicas (PubMed, arXiv, bioRxiv, Semantic Scholar). Genera markdown y PDF con citas verificadas en varios estilos (APA, Nature, Vancouver).

    Costo de contexto al activarse
    3.2k tok
    Tamaño del paquete
    12 archivos
    Última actualización
    hace 15 días
    investigacion

    Crea decks de diapositivas y presentaciones para charlas de investigación: PowerPoint, presentaciones de conferencia, seminarios, defensas de tesis. Da estructura, plantillas, guía de tiempos y validación visual.

    Costo de contexto al activarse
    5.1k tok
    Tamaño del paquete
    24 archivos
    Última actualización
    hace 15 días
    documentos

    Crea infografías profesionales con Nano Banana Pro AI y refinamiento iterativo inteligente. Usa Gemini 3.6 Flash para revisar la calidad e integra investigación con Perplexity Sonar. Soporta 10 tipos, 8 estilos y paletas para daltonismo.

    Costo de contexto al activarse
    2.7k tok
    Tamaño del paquete
    8 archivos
    Última actualización
    hace 15 días
    diseno ui

    Crea pósteres de investigación profesionales en LaTeX con beamerposter, tikzposter o baposter, para conferencias y comunicación científica: layout, colores, columnas múltiples e integración de figuras.

    Costo de contexto al activarse
    3.9k tok
    Tamaño del paquete
    17 archivos
    Última actualización
    hace 15 días
    documentos

    Crea diagramas científicos de calidad de publicación con la IA Nano Banana 2 y refinamiento iterativo inteligente. Gemini 3.6 Flash revisa la calidad y solo regenera si está por debajo del umbral de tu tipo de documento.

    Costo de contexto al activarse
    4.1k tok
    Tamaño del paquete
    6 archivos
    Última actualización
    hace 15 días
    diseno ui

    Skills relacionados

    Astropy

    34.8k

    Librería Python central para astronomía y astrofísica: unidades/cantidades, coordenadas, E/S de FITS, tablas, sistemas de tiempo, WCS y cosmología, para implementar o depurar código con Astropy.

    Costo de contexto al activarse
    3.6k tok
    Tamaño del paquete
    8 archivos
    Última actualización
    el mes pasado
    investigacion

    Integración con el SDK de Python de Benchling y su API REST para entidades del registro, inventario, entradas del cuaderno electrónico (ELN), workflows, Benchling Apps y consultas al Data Warehouse.

    Costo de contexto al activarse
    1.9k tok
    Tamaño del paquete
    6 archivos
    Última actualización
    el mes pasado
    investigacion

    Busca papers científicos y obtiene datos experimentales estructurados extraídos de estudios a texto completo vía el servidor MCP de BGPT: más de 25 campos por paper (métodos, resultados, muestras, calidad, conclusiones).

    Costo de contexto al activarse
    713 tok
    Tamaño del paquete
    1 archivo
    Última actualización
    el mes pasado
    investigacion