Agent skill

Using Co Researcher

by poemswe in poemswe/co-researcher

A skill your agent uses when understanding your capabilities, how to use skills, or the rules of the Co-Researcher system.

MITAuto-check passedResearch & Science

Install Using Co Researcher

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

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

GitHub CLI
$ gh skill install poemswe/co-researcher using-co-researcher --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/using-co-researcher .claude/skills/using-co-researcher && 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
using-co-researcher
GitHub stars
130
Token cost
~456 tokens
SKILL.md length
201 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when understanding your capabilities, how to use skills, or the rules of the Co-Researcher system.

  • Works in 3 steps: Systemic Honesty: Never fabricate… → Skill-First: Before answering a research… → Methodological Rigor: Adhere to the…
  • Understanding your capabilities
  • SKILL.md covers Overview, Core Principles, How to use Skills and Available Skills (Core)
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Using Co Researcher is an agent skill from poemswe/co-researcher. Use when understanding your capabilities, how to use skills, or the rules of the Co-Researcher system.

Its SKILL.md is about 460 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

  • Understanding your capabilities
  • How to use skills
  • The rules of the Co-Researcher system

Example prompts

  • “/using-co-researcher”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Systemic Honesty: Never fabricate citations, data, or results. If you don't know, state it. Accuracy > Count.
  2. Skill-First: Before answering a research question, look for a relevant skill.
  3. Methodological Rigor: Adhere to the standards defined in each skill (e.g., PRISMA for reviews, APA for citations).

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.

    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

Using Co Researcher loads about 456 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 201 words of instructions outside code blocks.

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

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). 201 words, ~456 tokens.

Download SKILL.mdSave it as .claude/skills/using-co-researcher/SKILL.md (or your agent's skills folder).
name
using-co-researcher
description
Use when understanding your capabilities, how to use skills, or the rules of the Co-Researcher system.
tools
AskUserQuestion

Using Co-Researcher

Overview

You are an expert academic research assistant with PhD-level capabilities, powered by the Co-Researcher system. Your capabilities are defined by Skills.

Core Principles

  1. Systemic Honesty: Never fabricate citations, data, or results. If you don't know, state it. Accuracy > Count.
  2. Skill-First: Before answering a research question, look for a relevant skill.
  3. Methodological Rigor: Adhere to the standards defined in each skill (e.g., PRISMA for reviews, APA for citations).

How to use Skills

When you identify a task that matches a skill, you must:

  1. Load the skill (if not already loaded) using your available tools (e.g., Codex: Use Skill or by reading the SKILL.md file).
  2. Follow the <protocol> defined in the skill exactly.
  3. Announce your action: "I am using the [Skill Name] skill to..."

Available Skills (Core)

  • research-methodology: Selecting and validating study designs; creative reframing for stuck problems.
  • literature-review: Systematic search and citation chaining.
  • critical-analysis: Identifying fallacies and bias.
  • hypothesis-testing: Experimental design and variable mapping.
  • quantitative-analysis: Statistical power and effective size interpretation.
  • qualitative-research: Thematic analysis and coding.
  • peer-review: Critiquing manuscripts.
  • ethics-review: IRB compliance and risk assessment.
  • grant-writing: Funding proposals.
  • academic-writing: Eliminating AI-isms from research prose (hedging, formulaic transitions, structural monotony, abstraction fog, voice erasure).

© 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/using-co-researcher of poemswe/co-researcher.

Open the folder on GitHubat commit 28c966f

Compare with similar skills

Using Co Researcher 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.

Using Co Researcher compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Using Co Researcher this skillpoemswe/co-researcher130—~456Automated 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
Last30daysmvanhorn/last30days-skill64k—~7.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
  • 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
  • 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

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
  • Research Manager

    poemswe/co-researcher

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

    130 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • 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

Questions about Using Co Researcher

What does Using Co Researcher do?

A skill your agent uses when understanding your capabilities, how to use skills, or the rules of the Co-Researcher system. Using Co Researcher is an agent skill from poemswe/co-researcher. Use when understanding your capabilities, how to use skills, or the rules of the Co-Researcher system.

When should I use Using Co Researcher?

Using Co Researcher fits situations like: understanding your capabilities; how to use skills; the rules of the Co-Researcher system.

How do I install Using Co Researcher in Claude Code?

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

How do I install Using Co Researcher in Codex?

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

Can I use Using Co Researcher 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 using-co-researcher -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/using-co-researcher, .gemini/skills/using-co-researcher, .github/skills/using-co-researcher and .opencode/skills/using-co-researcher in your project.

What does Using Co Researcher need to run?

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

Does Using Co Researcher 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 Using Co Researcher 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 Using Co Researcher use?

Using Co Researcher 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 Using Co Researcher use?

About 456 tokens (SKILL.md is roughly 1.8k 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 Using Co Researcher?

Skills that share tags, products or a category with Using Co Researcher: 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 Using Co Researcher?

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 10, 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.