Agent skill

Research Methodology

by poemswe in poemswe/co-researcher

You must use this when matching research questions to appropriate designs, sampling strategies, or validity controls — or when a research problem is stuck and needs creative reframing (cross-domain…

MITAuto-check passedResearch & Science

Install Research Methodology

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

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

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

At a glance

You must use this when matching research questions to appropriate designs, sampling strategies, or validity controls — or when a research problem is stuck and needs creative reframing (cross-domain…

  • Works in 4 steps: Research Question Classification → Design Specializations → Validity & Quality Control → …
  • Tasks that involve Experimental design
  • SKILL.md covers 1. Research Question…, 2. Design Specializations, 3. Validity & Quality Control and 4. Creative Reframing (when…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Research Methodology is an agent skill from poemswe/co-researcher. You must use this when matching research questions to appropriate designs, sampling strategies, or validity controls — or when a research problem is stuck and needs creative reframing (cross-domain analogies, first-principles deconstruction).

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, covering Experimental design and Hypothesis generation. 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

  • Tasks that involve Experimental design
  • Tasks that involve Hypothesis generation

Example prompts

  • “/research-methodology”

Workflow steps

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

  1. Research Question Classification
  2. Design Specializations
  3. Validity & Quality Control
  4. Creative Reframing (when the problem is stuck)

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

Research Methodology loads about 1.1k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 448 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
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). 448 words, ~1,096 tokens.

Download SKILL.mdSave it as .claude/skills/research-methodology/SKILL.md (or your agent's skills folder).
name
research-methodology
description
You must use this when matching research questions to appropriate designs, sampling strategies, or validity controls — or when a research problem is stuck and needs creative reframing (cross-domain analogies, first-principles deconstruction).
tools
WebSearch, WebFetch, Read, Grep, Glob
<role>
You are a PhD-level expert in research methodology with rigorous training in experimental design, qualitative frameworks, and mixed-methods integration. Your goal is to guide researchers in matching their methodology to their research questions with absolute precision and transparency.
</role>
<principles>
- **Methodological Fit**: Always match methodology to research question, not the reverse.
- **Transparency**: Explicitly discuss trade-offs between different methodological choices.
- **Rigor Standards**: Adhere to discipline-specific standards (e.g., GRADE, CONSORT, QUALMAT, ACM).
- **Factual Integrity**: Never invent sources or data. Every methodological recommendation must be evidence-based.
- **Uncertainty Calibration**: Honestly discuss threats to validity and the limitations of chosen designs.
</principles>
<competencies>

1. Research Question Classification

TypeKey WordsMethodology Family
ExploratoryWhat, How, ExperienceQualitative, Mixed
DescriptivePrevalence, PatternsSurvey, Observational
ComparativeDifferences, ImprovementExperimental, Quasi-exp
RelationalAssociation, PredictionCorrelational, Regression
CausalEffect, ImpactRCT, Quasi-experimental
MechanismHow does, WhyQualitative, Mixed

2. Design Specializations

  • Quantitative: RCTs, Quasi-experimental, Surveys, Longitudinal.
  • Qualitative: Phenomenology, Grounded Theory, Thematic Analysis, Ethnography, Case Study.
  • Mixed Methods: Sequential (Exploratory/Explanatory), Convergent Parallel, Embedded.

3. Validity & Quality Control

  • Quantitative Quality: Power analysis (N size), randomization, blinding, ITT analysis.
  • Qualitative Quality: Trustworthiness, saturation, reflexivity, member checking.
  • Mixed Methods Quality: Integration points, weighting, addressing divergence.

4. Creative Reframing (when the problem is stuck)

Use when standard designs fail or the researcher faces a genuine bottleneck, not as a default step.

  • Assumption Inversion: Name the unstated assumptions ("the Box"), then invert each one — "instead of making X stronger, how do we make its failure useful?"
  • First-Principles Deconstruction: Reduce the problem to its fundamental physical/mathematical truths and rebuild the design from there.
  • Cross-Domain Analogy: Search for structurally similar problems in distant fields; borrow the mechanism, not the surface. Every analogy must rest on verified science — never invent a principle to justify a creative leap.
  • Feasibility Audit: Any reframed approach still passes step 5 of the protocol (threats-to-validity) before it is recommended; label speculative leaps as speculative.
Show full SKILL.md (136 more words)Show less
</competencies>
<protocol>
1. **Clarify Research Question**: Extract the phenomenon, population, and context.
2. **Classify Question Type**: Map to the appropriate methodological family.
3. **Identify Candidate Designs**: Present 2-3 approaches with specific Pros/Cons/Trade-offs.
4. **Design Specification**: Define participants (sampling), instruments (collection), and analysis strategy.
5. **Validation & Limitations**: Conduct a threats-to-validity audit and state what the design cannot answer.
</protocol>

<output_format>

Methodological Guidance: [Research Question]

Classification: [Type + reasoning]

Recommended Approach: [Design Name]

  • Justification: Why this fits the RQ best.
  • Participants: [N, sampling strategy]
  • Procedures: [Data collection + duration]
  • Analysis: [Software + approach]

Validity Assessment: [Threats + mitigation] Limitations: [Constraints on generalizability or causality] </output_format>

<checkpoint>
After initial guidance, ask:
- Would you like to explore alternative designs for higher feasibility?
- Should I conduct a detailed power analysis for your proposed sample?
- Do you need specific quality standards for a target journal?
</checkpoint>

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

Open the folder on GitHubat commit 28c966f

Compare with similar skills

Research Methodology 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 Methodology compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Methodology this skillpoemswe/co-researcher130—~1.1kAutomated safety check: PassMIT
Claim-Driven Experiment PlannerzjYao36/Auto-Research-Refine1286 repos~2.3kAutomated safety check: NotesNone
Metabolic Study Planneraiming-lab/AutoResearchClaw15k—~1.9kAutomated safety check: PassMIT
Research RefinezjYao36/Auto-Research-Refine1286 repos~6.9kAutomated safety check: NotesNone
Scientific BrainstormingOleafly/Oleafly2092 repos~3.5kAutomated safety check: PassMIT
Academic GrillExekiel179/psyclaw103—~2kAutomated safety check: PassMIT

Similar skills

  • Claim-Driven Experiment Planner

    zjYao36/Auto-Research-Refine

    Turns a refined research proposal into a claim-to-evidence-to-run-order roadmap instead of a sprawling benchmark wishlist.

    128 GitHub starsUsed in 6 repos~2.3k tokens
    Research & ScienceAuto-check: notes
  • Metabolic Study Planner

    aiming-lab/AutoResearchClaw

    Turns a broad metabolic modelling topic into a concrete, paper-shaped plan with organism, model, perturbations, metrics and figures before any FBA code is written.

    15k GitHub stars~1.9k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Research Refine

    zjYao36/Auto-Research-Refine

    Turns a vague research direction into a focused, problem-anchored method plan through up to five review rounds with a second model.

    128 GitHub starsUsed in 6 repos~6.9k tokens
    Research & ScienceAuto-check: notes
  • Facilitates evidence-aware scientific ideation with independent generation, structured discussion, explicit assumptions, transparent evaluation, adversarial review, and decision logs.

    209 GitHub starsUsed in 2 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Academic Grill

    Exekiel179/psyclaw

    Stress-test an academic research question, proposal, study design, analysis plan, manuscript claim, review protocol, or AI research project through a one-question-at-a-time interview until its…

    103 GitHub stars~2k tokensUpdated 11 days ago
    Research & ScienceAuto-check passed
  • Denario

    davila7/claude-code-templates

    Multiagent AI system for scientific research assistance that automates research workflows from data analysis to publication.

    32k GitHub starsUsed in 8 repos~1.5k 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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    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 yesterday
    Auto-check passed

Questions about Research Methodology

What does Research Methodology do?

You must use this when matching research questions to appropriate designs, sampling strategies, or validity controls — or when a research problem is stuck and needs creative reframing (cross-domain…. Research Methodology is an agent skill from poemswe/co-researcher. You must use this when matching research questions to appropriate designs, sampling strategies, or validity controls — or when a research problem is stuck and needs creative reframing (cross-domain analogies, first-principles deconstruction).

When should I use Research Methodology?

Research Methodology fits situations like: tasks that involve Experimental design; tasks that involve Hypothesis generation.

How do I install Research Methodology in Claude Code?

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

How do I install Research Methodology in Codex?

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

Can I use Research Methodology 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-methodology -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-methodology, .gemini/skills/research-methodology, .github/skills/research-methodology and .opencode/skills/research-methodology in your project.

What does Research Methodology need to run?

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

Does Research Methodology 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 Methodology 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 Methodology use?

Research Methodology 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 Methodology use?

About 1.1k tokens (SKILL.md is roughly 4.4k 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 Methodology?

Skills that share tags, products or a category with Research Methodology: Claim-Driven Experiment Planner (zjYao36/Auto-Research-Refine, 128 stars), Metabolic Study Planner (aiming-lab/AutoResearchClaw, 15k stars), Research Refine (zjYao36/Auto-Research-Refine, 128 stars) and Scientific Brainstorming (Oleafly/Oleafly, 209 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Methodology?

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.