Agent skill

Research Manager

by poemswe in poemswe/co-researcher

Use this when starting a new research project or managing a complex, multi-step research workflow.

MITAuto-check passedResearch & Science

Install Research Manager

skills CLI
$ npx skills add poemswe/co-researcher --skill research-manager -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install poemswe/co-researcher research-manager --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/poemswe/co-researcher.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/research-manager .claude/skills/research-manager && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
research-manager
GitHub stars
130
Token cost
~1.1k tokens
SKILL.md length
474 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Use this when starting a new research project or managing a complex, multi-step research workflow.

  • Works in 3 steps: Ingestion & Scoping → Protocol: Dynamic Scaffolding → Execution & Delegation
  • Research & Science work in your project
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Research Manager is an agent skill from poemswe/co-researcher. Use this when starting a new research project or managing a complex, multi-step research workflow.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science. The repository describes itself as: A professional research suite for conducting rigorous academic research using specialized agents and multi-platform CLI commands. Compatible with Claude Code, Gemini CLI, OpenAI… The licence is MIT.

When your agent uses it

  • Research & Science work in your project

Example prompts

  • “/research-manager”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Ingestion & Scoping
  2. Protocol: Dynamic Scaffolding
  3. Execution & Delegation

What it can do on your machine

Read from SKILL.md and the folder at commit 28c966f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Research Manager loads about 1.1k tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 474 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from poemswe/co-researcher at commit 28c966f, republished under its MIT licence (© poemswe). 474 words, ~1,129 tokens.

Download SKILL.mdSave it as .claude/skills/research-manager/SKILL.md (or your agent's skills folder).
name
research-manager
description
Use this when starting a new research project or managing a complex, multi-step research workflow.
tools
Task, WebSearch, WebFetch, Read, Write, AskUserQuestion
<role>
You are the **Principal Investigator** and **Project Manager**. Your goal is NOT to do all the research yourself immediately, but to **plan, structure, and orchestrate** a rigorous research project using persistent Tasks.
</role>
<principles>
1.  **Plan First**: Never dive into searching without a plan. Always scaffold the project first.
2.  **Atomic Tasks**: Break work into small, verifiable chunks (e.g., "Find 5 papers" not "Review literature").
3.  **Dependency Management**: Identify what blocks what. (Analysis cannot happen before Retrieval).
4.  **Persistence**:
    *   **Project state**: `project.json` in the project workspace is the source of truth (see `<project_state>`). Read it first, write it last.
    *   **Task tracking**: Use the `Task` tool if available; otherwise mirror the checklist in `research-tasks.md`.
    *   *Goal*: Ensure work can resume across sessions on ANY platform.
</principles>

<project_state> Every project gets a workspace directory research/{slug}/ anchored at the user's invocation directory, containing project.json:

json
{
  "question": "the research question, verbatim",
  "methodology": "design recommended by research-methodology",
  "phase": "scoping | retrieval | analysis | synthesis | done",
  "workspaces": {"review": "review/{slug}/ if a literature funnel exists"},
  "decisions": [{"date": "YYYY-MM-DD", "decision": "...", "why": "..."}],
  "next_action": "the single next unblocked step, stated concretely"
}

Read-first: At the start of every session, before planning anything, check for an existing research/{slug}/project.json matching the topic. If found, resume from its phase and next_action — do not re-derive the plan. Write-last: After every completed task or user decision, update phase, append to decisions, and rewrite next_action. A session that changed project state but not project.json is unfinished. </project_state>

<workflow>
1. Ingestion & Scoping

Analyze the user's request. Is it a quick question or a project?

  • Quick: Answer directly using multi-source-investigation.
  • Project: Proceed to Task Scaffolding.
  • Clarification: If the request is ambiguous:
    • If AskUserQuestion is available: Call it to request details.
    • Otherwise: Ask the user directly in the conversation.
Show full SKILL.md (225 more words)Show less
2. Protocol: Dynamic Scaffolding

DO NOT assume a standard workflow. Design the project based on the specific research question.

  1. Phase 1: Methodology Consultation (CRITICAL)

    • Action: Invoke research-methodology skill.
    • Query: "Target Topic: [Topic]. Recommend the optimal research design and phase breakdown."
    • Wait for the design output (e.g., "Systematic Review", "Ethnography", "A/B Test").
  2. Phase 2: Task Generation

    • Action: Transform the methodology's phases into a Task list.
    • Constraint: Every task must have a clear DONE condition.
    • Example: If Method="Systematic Review":
      • Task: Search Strategy (Dependencies: None)
      • Task: Screening (Dependencies: Search Strategy)
      • Task: Extraction (Dependencies: Screening)
  3. Phase 3: Persistence

    • Initialize research/{slug}/project.json with the question, methodology, phase: "scoping", and the first next_action.
    • If Task tool is available: Use it immediately to persist the list.
    • Otherwise: Create research/{slug}/research-tasks.md with the checklist.
    • Output: Confirm the plan to the user.
3. Execution & Delegation

Once the plan is created (and approved by the user), start executing the first unblocked task.

  • Delegate: "I am now acting as the [Skill Name] to complete Task [X]..."
  • Update: Mark tasks as specific statuses (IN_PROGRESS, DONE) as you go, and keep project.json current per <project_state> — every completed task updates phase and next_action.
</workflow>

<output_format> Project Plan: [Topic]

Objective: [One sentence goal]

Task List:

  • [1. Scoping]: [Description]
  • [2. Retrieval]: [Description] (Depends on 1)
  • ...

Ask the user: "Shall I initialize this task list and start with Phase 1?" </output_format>

© poemswe, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/research-manager of poemswe/co-researcher.

Open the folder on GitHubat commit 28c966f

Compare with similar skills

Research Manager next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Research Manager compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Manager this skillpoemswe/co-researcher130—~1.1kAutomated safety check: PassMIT
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
Peer Reviewspacering-net/codeg3.9k17 repos~5.9kAutomated safety check: NotesMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.9k GitHub starsUsed in 17 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes

More from poemswe/co-researcher

All 15 skills in this repo
  • Literature Review

    poemswe/co-researcher

    You must use this when synthesizing existing knowledge, identifying research gaps, or tracing the evolution of scientific ideas.

    130 GitHub stars~3.6k tokensUpdated today
    Auto-check: notes
  • Academic Writing

    poemswe/co-researcher

    You must use this when producing any research prose — literature reviews, syntheses, analyses, methodology descriptions, discussion sections, abstracts, or any written output intended for an…

    130 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Critical Analysis

    poemswe/co-researcher

    You must use this when analyzing claims, evaluating evidence, or Identifying logical fallacies in research.

    130 GitHub stars~781 tokensUpdated today
    Auto-check passed
  • Ethics Review

    poemswe/co-researcher

    You must use this when identifying ethical risks, ensuring participant privacy, or preparing IRB applications.

    130 GitHub stars~809 tokensUpdated today
    Auto-check passed
  • Grant Writing

    poemswe/co-researcher

    You must use this when drafting grant proposals, refining research aims, or aligning projects with agency priorities.

    130 GitHub stars~815 tokensUpdated today
    Auto-check passed
  • Hypothesis Testing

    poemswe/co-researcher

    You must use this when formulating testable hypotheses, designing experimental controls, or defining falsification criteria.

    130 GitHub stars~830 tokensUpdated today
    Auto-check passed

Questions about Research Manager

What does Research Manager do?

Use this when starting a new research project or managing a complex, multi-step research workflow. Research Manager is an agent skill from poemswe/co-researcher. Use this when starting a new research project or managing a complex, multi-step research workflow.

When should I use Research Manager?

Research Manager fits situations like: research & Science work in your project.

How do I install Research Manager in Claude Code?

Run `npx skills add poemswe/co-researcher --skill research-manager -a claude-code`. Or copy the skill folder (skills/research-manager in poemswe/co-researcher) into .claude/skills/research-manager in your project. Claude Code loads it when a task matches its description.

How do I install Research Manager in Codex?

Run `npx skills add poemswe/co-researcher --skill research-manager -a codex`. Or copy the skill folder (skills/research-manager in poemswe/co-researcher) into .agents/skills/research-manager in your project. Codex loads it when a task matches its description.

Can I use Research Manager in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add poemswe/co-researcher --skill research-manager -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/research-manager, .gemini/skills/research-manager, .github/skills/research-manager and .opencode/skills/research-manager in your project.

What does Research Manager need to run?

SKILL.md names no scripts, command-line tools or credentials: Research Manager is instructions for the agent only.

Does Research Manager access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Research Manager safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Research Manager use?

Research Manager is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Research Manager use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Research Manager?

Skills that share tags, products or a category with Research Manager: Hypothesis Generation (spacering-net/codeg, 3.9k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars) and Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Manager?

poemswe (a GitHub user) maintains it in poemswe/co-researcher, which has 130 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 8, 2026.

Source: poemswe/co-researcher on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.