research-refine

Refines vague research directions into anchored method proposals via iterative GPT-5.4 review rounds.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/zniihgnexy/vid_tokenizer --skill research-refine-zniihgnexy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research-refine
Source: https://github.com/zniihgnexy/vid_tokenizer/tree/main/.claude/skills/research-refine
Command: npx skills add https://github.com/zniihgnexy/vid_tokenizer --skill research-refine-zniihgnexy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns a fuzzy research idea into a concrete, implementation-ready method plan by freezing a Problem Anchor and iterating through structured external review until the proposal is focused, feasible, and top-venue ready. ## Core Features & Use Cases - Problem Anchor Freezing: Extracts the immutable bottom-line problem, constraints, and success conditions so every revision round stays on target and drift is explicitly flagged. - Iterative GPT-5.4 Review Loop: Sends proposals to a Codex-based reviewer across up to 5 rounds, scoring 7 dimensions (problem fidelity, method specificity, contribution quality, frontier leverage, feasibility, validation focus, venue readiness) until the score reaches 9. - Structured Logging: Saves every round's proposal, review, refinement, score history, and a final clean proposal under refine-logs/. - Use Case: A researcher has a vague idea like "improve long-video understanding with memory." The skill scans local papers, identifies the exact technical gap, drafts a minimal mechanism-level method, and iterates with GPT-5.4 until the plan is sharp enough to hand off to experiment planning. ## Quick Start Ask the assistant to refine your research plan by providing your problem and rough approach, for example: refine my approach on PROBLEM: long-video temporal grounding | APPROACH: add a memory module to the VLM.

Frequently Asked Questions about research-refine

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

FAQPage Schema
How do I refine a vague research idea into a concrete method plan?▼

Provide your problem and rough approach, and the skill freezes a Problem Anchor, scans local papers for the technical gap, drafts a focused proposal, then iterates with GPT-5.4 review rounds until the plan reaches a score of 9 or the round limit.

What does the GPT-5.4 review evaluate in a research proposal?▼

The reviewer scores seven dimensions: problem fidelity, method specificity, contribution quality, frontier leverage, feasibility, validation focus, and venue readiness. It also flags drift from the original problem and suggests simplification or modernization opportunities.

How many review rounds does the refinement loop run?▼

The loop runs up to 5 rounds by default and stops early when the overall score reaches 9 with a READY verdict and no unresolved drift. Both limits can be overridden via arguments.

Does research-refine require the Codex MCP tool?▼

Yes, the external review phases call GPT-5.4 through the Codex MCP tools (mcp__codex__codex and codex-reply) with xhigh reasoning effort. Without Codex access, the iterative review loop cannot execute.

What output files does the refinement process produce?▼

All artifacts are saved under refine-logs/, including per-round proposals and reviews, REVIEW_SUMMARY.md, FINAL_PROPOSAL.md, REFINEMENT_REPORT.md, and score-history.md tracking score evolution across rounds.

When should I not use research-refine?▼

Avoid it when you do not yet have a defined problem, since the skill assumes the research problem is already visible. For open-ended ideation use an idea-generation skill first, and for execution roadmaps use experiment planning afterward.