contribution-hypothesis-map

Maps literature contributions to baseline failures and ranks testable adaptation candidates.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/Nitrogen216/awesome-dsh-mods --skill contribution-hypothesis-map-nitrogen216
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: contribution-hypothesis-map
Source: https://github.com/Nitrogen216/awesome-dsh-mods/tree/main/modes/dsh-autoresearch/skills/contribution-hypothesis-map
Command: npx skills add https://github.com/Nitrogen216/awesome-dsh-mods --skill contribution-hypothesis-map-nitrogen216

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Autonomous research loops often jump from reading papers to changing code without a defensible link between prior work and the observed failure. This Skill converts deep-read literature and measured baseline results into a ranked pool of falsifiable adaptation candidates, so every code change is attributable to a specific mechanism. ## Core Features & Use Cases - Structured Candidate Mapping: Writes each candidate as a row in research/CONTRIBUTION_MAP.md covering source contribution, assumption, baseline match, hypothesis, falsification criterion, minimal adaptation, novelty risk, screen, and cost. - Guard-Allocated IDs: Runs transition_guard.py allocate-candidates to obtain stable candidate ids before writing rows, keeping the research state machine consistent. - Evidence-Based Ranking and Selection: Ranks candidates by mechanism match, source evidence strength, expected primary-metric effect, distinct contribution, and screening cost, then advances the mapping -> adaptation transition or returns to literature with an evidence_gap. - Use Case: After a baseline experiment fails and a literature refresh is complete, use this Skill to produce three to five ranked adaptation candidates with explicit falsification criteria before selecting the next experiment. ## Quick Start Map the current literature and baseline failure into ranked adaptation candidates and select the next one to test.

Frequently Asked Questions about contribution-hypothesis-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn research papers into testable experiment candidates?▼

Map each paper's mechanism to the observed baseline failure by recording its source assumption, baseline match, derived requirement, hypothesis, and falsification criterion in a contribution map. Rank candidates by mechanism match, evidence strength, expected metric effect, and screening cost before selecting one.

What makes a research adaptation candidate falsifiable?▼

A falsifiable candidate states a predicted primary-metric change plus an outcome that rejects the proposed mechanism rather than merely missing a target. Pure threshold searches, post-hoc score combinations, and unattributable bundles are rejected.

When should the mapping phase return to literature search?▼

Return mapping -> literature with outcome evidence_gap when no candidate has a defensible mechanism mapping to the observed failure. Include a targeted search question so the next literature refresh addresses the specific gap.

Can one candidate combine multiple source papers?▼

Multiple papers are allowed in one candidate only when they support the same mechanism and one attributable implementation. Independent mechanisms must be split into separate candidates so each experiment tests a single attributable change.

When is external escalation used during candidate selection?▼

Escalation to the askgpt-governor is reserved for cases where two or more literature-supported mechanism families remain defensible, evidence cannot distinguish them, and the choice changes the central hypothesis or architecture. Routine ranking ties are not escalated.