New to Claude Skills? Learn how to install them →

wanshuiyin on GitHub

Research Refine Pipeline

Free

Streamline your research and experiment planning process.

Get this skill

Free · Opens the source repo

What Research Refine Pipeline does

The Research Refine Pipeline skill enables users to seamlessly transition from vague research ideas to detailed proposals and experiment plans. This skill is particularly useful for researchers and developers who require a structured approach to refine their methods and validate claims through experiments. By integrating two existing workflows—research-refine and experiment-plan—this skill provides a comprehensive solution for generating coherent research outputs.

When using this skill, users start by triaging their initial ideas, extracting essential elements such as the problem statement, rough approach, and constraints. If a strong proposal already exists, the skill allows users to skip directly to experiment planning. However, if the proposal is outdated or unclear, the skill guides them through the method refinement stage, ensuring that the final thesis is robust and focused.

The output of this skill includes several key documents: a final proposal, a review summary, a detailed experiment plan, and a pipeline summary. These documents not only encapsulate the research findings but also provide a roadmap for future experiments, ensuring that the method is validated against the claims made in the proposal. The structured approach of this skill helps prevent premature experimentation on unstable methods, thereby increasing the likelihood of successful outcomes.

Overall, the Research Refine Pipeline skill is designed for those who want to maintain a high standard of rigor in their research processes, making it an essential tool for academic researchers, data scientists, and anyone involved in methodical experimentation.

When to use it

Use this skill when you need a cohesive workflow that combines method refinement with experiment planning for research projects.

When not to use it

Avoid this skill if you only need to refine a method or plan experiments separately, as it is designed for integrated workflows.

What you can build with it

Transitioning from Idea to Proposal

A researcher has a vague idea and uses this skill to refine it into a clear, actionable proposal.

Planning Experiments for a New Method

After refining a method, a developer utilizes the skill to create a detailed experiment plan that validates their claims.

Updating an Existing Proposal

When a research proposal becomes outdated, the skill helps the user revise and update it to align with current research needs.

How to install Research Refine Pipeline

View source

1. Install with the skills CLI

npx skills add wanshuiyin/auto-claude-code-research-in-sleep/research-refine-pipeline --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by wanshuiyin

Research Refine Pipeline: End-to-End Method and Experiment Planning

Refine and concretize: $ARGUMENTS

Overview

Use this skill when the user does not want to stop at a refined method. The goal is to produce a coherent package that includes:

  • a problem-anchored, elegant final proposal
  • the review history explaining why the method is focused
  • a detailed experiment roadmap tied to the paper's claims
  • a compact pipeline summary that says what to run next

This skill composes two existing workflows:

  1. research-refine for method refinement
  2. experiment-plan for claim-driven validation planning

For stage-specific detail, read these sibling skills only when needed:

  • ../research-refine/SKILL.md
  • ../experiment-plan/SKILL.md

Core Rule

Do not plan a large experiment suite on top of an unstable method. First stabilize the thesis. Then turn the stable thesis into experiments.

Default Outputs

  • refine-logs/FINAL_PROPOSAL.md
  • refine-logs/REVIEW_SUMMARY.md
  • refine-logs/REFINEMENT_REPORT.md
  • refine-logs/EXPERIMENT_PLAN.md
  • refine-logs/EXPERIMENT_TRACKER.md
  • refine-logs/PIPELINE_SUMMARY.md

Workflow

Phase 0: Triage the Starting Point

  • Extract the problem, rough approach, constraints, resources, and target venue.
  • Check whether refine-logs/FINAL_PROPOSAL.md already exists and still matches the current request.
  • If the proposal is missing, stale, or materially different from the current request, run the full research-refine stage.
  • If the proposal is already strong and aligned, reuse it and jump to experiment planning.
  • If in doubt, prefer re-running research-refine rather than planning experiments for the wrong method.

Phase 1: Method Refinement Stage

Run the research-refine workflow and keep its V3 philosophy intact:

  • preserve the Problem Anchor
  • prefer the smallest adequate mechanism
  • keep one dominant contribution
  • modernize only when it improves the paper

Exit this stage only when these are explicit:

  • the final method thesis
  • the dominant contribution
  • the complexity intentionally rejected
  • the key claims and must-run ablations
  • the remaining risks, if any

If the verdict is still REVISE, continue into experiment planning only if the remaining weaknesses are clearly documented.

Phase 2: Planning Gate

Before the experiment stage, write a short gate check:

  • What is the final method thesis?
  • What is the dominant contribution?
  • What complexity was intentionally rejected?
  • Which reviewer concerns still matter for validation?
  • Is a frontier primitive central, optional, or absent?

If these answers are not crisp, tighten the final proposal first.

Phase 3: Experiment Planning Stage

Run the experiment-plan workflow grounded in:

  • refine-logs/FINAL_PROPOSAL.md
  • refine-logs/REVIEW_SUMMARY.md
  • refine-logs/REFINEMENT_REPORT.md

Ensure the experiment plan covers:

  • the main anchor result
  • novelty isolation
  • a simplicity or deletion check
  • a frontier necessity check if applicable
  • run order, budget, and decision gates

Phase 4: Integration Summary

Write refine-logs/PIPELINE_SUMMARY.md:

# Pipeline Summary

**Problem**: [problem]
**Final Method Thesis**: [one sentence]
**Final Verdict**: [READY / REVISE / RETHINK]
**Date**: [today]

## Final Deliverables
- Proposal: `refine-logs/FINAL_PROPOSAL.md`
- Review summary: `refine-logs/REVIEW_SUMMARY.md`
- Experiment plan: `refine-logs/EXPERIMENT_PLAN.md`
- Experiment tracker: `refine-logs/EXPERIMENT_TRACKER.md`

## Contribution Snapshot
- Dominant contribution:
- Optional supporting contribution:
- Explicitly rejected complexity:

## Must-Prove Claims
- [Claim 1]
- [Claim 2]

## First Runs to Launch
1. [Run]
2. [Run]
3. [Run]

## Main Risks
- [Risk]:
- [Mitigation]:

## Next Action
- Proceed to `/run-experiment`

Phase 5: Present a Brief Summary to the User

Pipeline complete.

Method output:
- refine-logs/FINAL_PROPOSAL.md

Experiment output:
- refine-logs/EXPERIMENT_PLAN.md
- refine-logs/EXPERIMENT_TRACKER.md

Pipeline summary:
- refine-logs/PIPELINE_SUMMARY.md

Best next step:
- /run-experiment

Output Protocols

Follow these shared protocols for all output files:

Key Rules

  • Large file handling: If the Write tool fails due to file size, immediately retry using Bash (cat << 'EOF' > file) to write in chunks. Do NOT ask the user for permission — just do it silently.

  • Do not let the experiment plan override the Problem Anchor.

  • Do not widen the paper story after method refinement unless a missing validation block is truly necessary.

  • Reuse the same claims across FINAL_PROPOSAL.md, EXPERIMENT_PLAN.md, and PIPELINE_SUMMARY.md.

  • Keep the main paper story compact.

  • If the method is intentionally simple, defend that simplicity in the experiment plan rather than adding new components.

  • If the method uses a modern LLM / VLM / Diffusion / RL primitive, make its necessity test explicit.

  • If the method does not need a frontier primitive, say that clearly and avoid forcing one.

  • Prefer the staged skills when the user only needs one stage; use this skill for the integrated flow.

Composing with Other Skills

/research-refine-pipeline -> one-shot method + experiment planning
/research-refine   -> method refinement only
/experiment-plan   -> experiment planning only
/run-experiment    -> execution

Frequently asked questions about Research Refine Pipeline

Similar skills