research-merge — Claude Code skill: what it does, how to install
research-merge processes claude/research-* branches from web sessions, squash-merges documentation into docs/research/, and logs GitHub issues.
no license 1 installs ★ 492 updated 2026-10-25
npx skills add aiskillstore/marketplace --skill research-merge -a claude-codeWhat research-merge does
This skill organizes research branches created during Claude Code Web sessions. It fetches remote tracking branches matching claude/research-*, inspects their documentation summaries, and prompts for an action: full merge with a GitHub issue, merge only, postpone, or delete the remote branch.
During full execution, the skill runs a squash merge, relocates root-level RESEARCH*.md files into docs/research/, generates an issue via the GitHub CLI, and purges the remote branch. A summary report lists the status of each processed branch.
Do not run this on standard feature branches; it is tailored strictly for research notes. If the gh CLI tool is missing, the skill completes the merge and folder reorganization while skipping issue creation.
What it helps with
- squash-merge Claude Code Web research branches into main
- organize research notes under docs/research/
- generate GitHub issues from research findings automatically
- clean up obsolete claude/research-* remote branches
Example prompts for the agent
- /popkit:research merge
- Check for remote
claude/research-*branches and process their notes - Process research branch findings and file a GitHub issue
How to install research-merge
1Skills CLI (Vercel)
npx skills add aiskillstore/marketplace --skill research-merge -a claude-code2Manually: put the files in place
~/.claude/skills/research-merge/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/research-merge/
1Skills CLI (Vercel)
npx skills add aiskillstore/marketplace --skill research-merge -a codex2Manually: put the files in place
.agents/skills/research-merge/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aiskillstore/marketplace --skill research-merge -a cursor2Manually: put the files in place
.cursor/skills/research-merge/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aiskillstore/marketplace skills/jrc1883/research-merge2Manually: put the files in place
.github/skills/research-merge/SKILL.md1Skills CLI (Vercel)
npx skills add aiskillstore/marketplace --skill research-merge -a gemini-cli2Platform CLI
gemini skills install https://github.com/aiskillstore/marketplace --path skills/jrc1883/research-mergeManually: put the files in place
.devin/skills/research-merge/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aiskillstore/marketplace --skill research-merge -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about research-merge
How to install research-merge in Claude Code?
Run npx skills add aiskillstore/marketplace --skill research-merge -a claude-code. It creates the definition file at ~/.claude/skills/research-merge/SKILL.md.
Which branches does this skill support?
It targets branches matching claude/research-* or branches containing research markdown documents. Standard development branches should not be processed with it.
What happens if GitHub CLI is unavailable?
The skill performs the squash merge and moves documentation files as expected, but it skips the gh issue create step and records it in the final summary.