Agent skill

Product Research

by borghei in borghei/Claude-Skills

Continuous product discovery research operations — picking the method that fits the question, recruiting and screening participants, building interview guides, and scoring evidence into insights.

MITAuto-check passedBusiness, Finance & HR

Install Product Research

skills CLI
$ npx skills add borghei/Claude-Skills --skill product-research -a claude-code

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

GitHub CLI
$ gh skill install borghei/Claude-Skills product-research --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/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/research-ops/product-research .claude/skills/product-research && 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
product-research
GitHub stars
886
Token cost
~3.1k tokens
SKILL.md length
1,579 words
Files
10 (incl. scripts, references, assets)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

Continuous product discovery research operations — picking the method that fits the question, recruiting and screening participants, building interview guides, and scoring evidence into insights.

  • Works in 5 steps: Write the question in interrogative… → Classify the question: generative (what… → Rate decision reversibility and state… → …
  • Running discovery
  • SKILL.md covers When to use this skill, Inputs the skill expects, Clarify First and Workflows, plus 3 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Product Research is an agent skill from borghei/Claude-Skills. Continuous product discovery research operations — picking the method that fits the question, recruiting and screening participants, building interview guides, and scoring evidence into insights. Use when planning or running discovery.

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts, reference files and assets (for example `assets/interview-guide-template.md`, `assets/sample_evidence.json` and `assets/sample_research_question.json`).

It sits in Business, Finance & HR, covering Recruiting and HR. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Running discovery
  • Tasks that involve Recruiting and HR

Example prompts

  • “/product-research”

Requirements

  • Python 3

Workflow steps

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

  1. Write the question in interrogative form. If it starts with "should we," it
  2. Classify the question: generative (what is going on), evaluative (does this
  3. Rate decision reversibility and state the timeline and participant access.
  4. Run the recommender. It returns a primary method, a cheaper fallback, the
  5. If the recommendation is "ship an experiment instead," take that seriously.

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. 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

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Product Research loads about 3.1k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 63 tokens; SKILL.md has 1,579 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 1,579 words, ~3,056 tokens.

Download SKILL.mdSave it as .claude/skills/product-research/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
product-research
description
Continuous product discovery research operations — picking the method that fits the question, recruiting and screening participants, building interview guides, and scoring evidence into insights. Use when planning or running discovery.
license
MIT + Commons Clause
metadata.version
1.0.0
metadata.author
borghei
metadata.category
research-ops
metadata.domain
product-discovery
metadata.updated
2026-07-21
metadata.tags
discovery, user-research, interviews, screener, synthesis, research-ops

Product Research

The operational layer of continuous product discovery: choosing a method that actually answers the question asked, recruiting the right people without poisoning the sample, running interviews that surface behaviour rather than opinion, and converting a pile of session notes into insights with an honest confidence attached.

When to use this skill

  • A team is about to build something and the evidence behind it is three sales anecdotes and a strongly held opinion
  • Choosing a method — someone has asked for "a survey" or "some user interviews" before anyone has written down the question
  • Designing a screener for a study where recruiting the wrong participants would be worse than not running it
  • Writing an interview guide that has to be run consistently by several people across a dozen sessions
  • Synthesising evidence into insights after a round of discovery, with a defensible confidence level on each claim
  • Standing up a continuous discovery cadence — a repeatable weekly rhythm rather than one-off project research

Inputs the skill expects

  • The decision the research feeds, and who makes it
  • The question in interrogative form — what you do not know, not what you want confirmed
  • Decision reversibility — can this be undone in a sprint, or is it a one-way door
  • Timeline and budget for the study
  • Access to participants: existing customers, prospects, panel, or none
  • Existing evidence already on hand (tickets, session recordings, sales calls)

Clarify First

Before generating, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • The decision this research informs, and its reversibility — a one-way door justifies weeks of evidence; a reversible change is often better answered by shipping an experiment
  • The question in interrogative form — "do users want X" and "how do users currently accomplish X" call for completely different methods
  • Participant access — whether you can reach real users determines whether the plan is feasible at all, and it is the constraint teams discover last
  • Timeline — a two-day answer and a three-week answer are different studies, not the same study rushed

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Workflows

Workflow 1 — Pick the method before anyone books a session
  1. Write the question in interrogative form. If it starts with "should we," it is a decision, not a research question — rewrite it as what you would need to know to decide.
  2. Classify the question: generative (what is going on), evaluative (does this work), or descriptive (how many, how often).
  3. Rate decision reversibility and state the timeline and participant access.
  4. Run the recommender. It returns a primary method, a cheaper fallback, the minimum sample, and the methods it explicitly ruled out with reasons.
  5. If the recommendation is "ship an experiment instead," take that seriously. For reversible decisions, an experiment usually beats a study on both speed and evidence quality.
bash
python3 research-ops/product-research/scripts/method_recommender.py \
  --input research-ops/product-research/assets/sample_research_question.json \
  --format text
Workflow 2 — Validate the screener before recruiting opens
  1. Draft the screener: qualifying criteria, disqualifying criteria, and the items that test each.
  2. Run the validator. It checks for transparent qualifying answers, missing disqualification logic, professional-respondent exposure, quota coverage, and criteria that no item actually tests.
  3. Fix every fail. A screener defect costs you the whole study — you find out only during the sessions, by which point the incentives are spent.
bash
python3 research-ops/product-research/scripts/screener_validator.py \
  --input research-ops/product-research/assets/sample_screener.json \
  --format text
Workflow 3 — Score insight confidence during synthesis
  1. Draft each candidate insight as a claim, and attach the evidence items that support it — each with its source type, participant, and whether it is observed behaviour or reported opinion.
  2. Run the scorer. It weights observed evidence above reported evidence, rewards source and participant diversity, and penalises claims resting on a single session or a single channel.
  3. Ship only the insights scoring moderate or above as decision inputs. Everything below that is a hypothesis and must be labelled as one.
bash
python3 research-ops/product-research/scripts/insight_confidence_scorer.py \
  --input research-ops/product-research/assets/sample_evidence.json \
  --format text

Decision frameworks

Method by question type
Question typeExamplePrimary methodMinimum sample
Generative — what is going on"How do support agents currently triage tickets?"[PROVEN] Contextual inquiry or semi-structured interview6-8
Evaluative — does this work"Can users complete onboarding unaided?"[PROVEN] Moderated usability test5-8
Comparative — which is better"Which of two flows converts?"[PROVEN] A/B experimentPowered by traffic
Descriptive — how many, how often"What share of accounts hit this limit?"[PROVEN] Instrumentation or log analysisFull population
Prioritisation — which matters most"Which of five problems is most acute?"[RECOMMENDED] Survey with forced trade-offs100+
Desirability — would people want this"Would customers use X?"[RECOMMENDED] Painted-door or pre-commitment testTraffic-dependent
Diagnostic — why did this drop"Why did activation fall 12%?"[RECOMMENDED] Funnel analysis first, then targeted interviews5-6 after analysis

The pattern worth internalising: quantitative methods tell you what and how many; qualitative methods tell you why and how. Reaching for interviews to answer a "how many" question, or for a survey to answer a "why" question, is the most common and most expensive method error in product research.

Reversibility gate
Decision typeEvidence barTypical spend
Reversible in a sprintShip it behind a flag and measureHours. Research here is usually waste.
Reversible in a quarter5-6 interviews or one experimentDays
Costly to reverse — pricing, data model, public APIMixed methods; qual for the why, quant for the size1-3 weeks
One-way door — platform, contract, market entryTriangulated across 3+ independent sourcesWeeks, and worth it

[PROVEN] Match evidence spend to reversibility, not to how interesting the question is. The most common research-ops failure is not too little research — it is expensive research on reversible decisions while one-way doors get decided on intuition.

Show full SKILL.md (643 more words)Show less
Saturation — when to stop interviewing

Track new themes per session. Stop when two consecutive sessions produce no new theme.

Sessions runTypical state
1-3Every session is new. Do not synthesise yet — you are pattern-matching on noise.
4-6Themes start repeating. First real patterns appear.
7-9Saturation for a homogeneous segment. Diminishing returns set in hard.
10-12Needed only when covering 2+ distinct segments — treat each segment as its own count.
15+Almost always over-research, unless the segments are genuinely many

The count that matters is per segment, not in total. Eight sessions spread across four segments is two per segment, which is anecdote.

Anti-Patterns

The Confirmation Study

Mistake: Running research after the decision is made, with a question phrased to validate it — "we want to check users like the new dashboard." Why it happens: The team needs air cover for a choice already funded, and nobody wants to be the person whose study kills the roadmap item. Instead: Write down, before recruiting, what result would cause you to change course. If no such result exists, cancel the study and save the money — you are buying decoration, not evidence. Getting that sentence written is also the fastest way to discover the decision was never really open.

Asking Users to Design

Mistake: "What features would you like to see?" and treating the answers as a roadmap. Why it happens: It feels maximally user-centred, and it produces concrete output quickly. Instead: Ask about the last time they hit the problem — what they were doing, what they tried, what it cost them. People are reliable reporters of their own experience and unreliable designers of solutions. Extract the problem from the story; the solution is your job.

Sample of Convenience

Mistake: Interviewing whoever answers the recruiting email — usually your most engaged power users — and generalising to the whole base. Why it happens: They respond fastest, they are pleasant to talk to, and the sessions feel productive. Instead: Recruit against a quota that includes the segments you most need to hear from — churned users, low-engagement accounts, people who evaluated you and chose a competitor. Those are harder to reach and worth several times more per session. If you can only get power users, say so explicitly in the writeup and scope the conclusion to them.

Synthesis by Highlight Reel

Mistake: Building the findings deck from the most quotable moments across sessions. Why it happens: Vivid quotes are persuasive and memorable, and a striking quote from one participant carries more weight in a readout than a pattern across six. Instead: Count first, quote second. Establish how many participants exhibited each theme, then select a quote to illustrate a theme you have already quantified. A quote is an illustration of evidence, never the evidence itself.

Research Theatre on a Reversible Decision

Mistake: A three-week study to decide something that could be shipped behind a flag on Tuesday and measured by Friday. Why it happens: A research process exists, so it gets applied uniformly regardless of what is at stake. Instead: Run the reversibility gate first. If the decision is reversible in a sprint, ship the experiment — it produces better evidence (observed behaviour at real scale) faster and cheaper than any study. Reserve the research capacity for the one-way doors that are currently being decided on nothing at all.

Files

FilePurpose
scripts/method_recommender.pyRecommends a research method from question type, reversibility, timeline, and access
scripts/screener_validator.pyChecks a screener for transparency, missing disqualification logic, and quota coverage
scripts/insight_confidence_scorer.pyScores insight confidence from evidence count, type, and source diversity
references/method-selection-guide.mdEvery method with cost, sample, output, and the questions it cannot answer
references/interview-craft.mdGuide construction, probing technique, moderator failure modes, synthesis mechanics
assets/interview-guide-template.mdThe structure a semi-structured discovery guide ships in
assets/sample_research_question.jsonRunnable input for the method recommender
assets/sample_screener.jsonRunnable input for the screener validator
assets/sample_evidence.jsonRunnable input for the insight confidence scorer

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

Files

SKILL.md and 9 other files (scripts, references, assets) in research-ops/product-research of borghei/Claude-Skills.

  • SKILL.md
  • assets/interview-guide-template.md
  • assets/sample_evidence.json
  • assets/sample_research_question.json
  • assets/sample_screener.json
  • references/interview-craft.md
  • references/method-selection-guide.md
  • scripts/insight_confidence_scorer.py
  • scripts/method_recommender.py
  • scripts/screener_validator.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

Product Research 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.

Product Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Product Research this skillborghei/Claude-Skills886—~3.1kAutomated safety check: PassMIT
Get Jobagentenatalie/get-job.skill629—~1.7kAutomated safety check: PassCC-BY-NC-ND-4.0
Resume Reviewerweeelin98/ResumeDom169—~2.4kAutomated safety check: PassNone
Build Resume Portfolio Sitetao943/build-resume-portfolio-site195—~5.8kAutomated safety check: PassNone
Cyber Resume Reviewermubix/cyber-resume-reviewer-skill184—~2.9kAutomated safety check: PassMIT
Repo To Resume TailorSsabby1/repo-to-resume-tailor127—~1.8kAutomated safety check: PassMIT

Similar skills

  • Get Job

    agentenatalie/get-job.skill

    实习.skill / get-job.skill:从岗位调研、简历改写到分轮次面试准备的全流程求职 skill。适合找工作、投实习、校招、秋招、春招、暑期实习、社招、跳槽、转行、跨专业求职、留学生求职,以及产品经理、运营、市场、咨询、AI 产品、AI Coding、数据分析、技术岗等目标岗位准备。

    629 GitHub stars~1.7k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Resume Reviewer

    weeelin98/ResumeDom

    Build, assess, review, and tailor evidence-backed US-market technology resumes for computer-science interns and new graduates.

    169 GitHub stars~2.4k tokensUpdated 13 days ago
    Business, Finance & HRAuto-check passed
  • Build Resume Portfolio Site

    tao943/build-resume-portfolio-site

    A skill your agent uses when turning resume materials and an optional job description into verified, approved content and a runnable React + Vite resume or portfolio site, or when redesigning an…

    195 GitHub stars~5.8k tokensUpdated 9 days ago
    Business, Finance & HRAuto-check passed
  • Cyber Resume Reviewer

    mubix/cyber-resume-reviewer-skill

    Review, tailor, score, or rewrite IT and cybersecurity resumes.

    184 GitHub stars~2.9k tokensUpdated 18 days ago
    Business, Finance & HRAuto-check passed
  • Repo To Resume Tailor

    Ssabby1/repo-to-resume-tailor

    Analyze a full code repository and generate one resume-ready project description grounded in repository evidence.

    127 GitHub stars~1.8k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • This skill helps users extract GitHub repository project details and contributor contact information using keywords, stars, and update dates.

    6.1k GitHub starsUsed in 1 repo~1.9k tokens
    Business, Finance & HRAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    886 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    886 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    886 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    886 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed

Questions about Product Research

What does Product Research do?

Continuous product discovery research operations — picking the method that fits the question, recruiting and screening participants, building interview guides, and scoring evidence into insights. Product Research is an agent skill from borghei/Claude-Skills. Continuous product discovery research operations — picking the method that fits the question, recruiting and screening participants, building interview guides, and scoring evidence into insights.

When should I use Product Research?

Product Research fits situations like: running discovery; tasks that involve Recruiting and HR.

How do I install Product Research in Claude Code?

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

How do I install Product Research in Codex?

Run `npx skills add borghei/Claude-Skills --skill product-research -a codex`. Or copy the skill folder (research-ops/product-research in borghei/Claude-Skills) into .agents/skills/product-research in your project. Codex loads it when a task matches its description.

Can I use Product Research 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 borghei/Claude-Skills --skill product-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/product-research, .gemini/skills/product-research, .github/skills/product-research and .opencode/skills/product-research in your project.

What does Product Research need to run?

Going by SKILL.md and its folder, Product Research needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Product Research 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 Product Research 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Product Research use?

Product Research is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Product Research use?

About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.7k tokens, read only when the agent opens those files.

What are the alternatives to Product Research?

Skills that share tags, products or a category with Product Research: Get Job (agentenatalie/get-job.skill, 629 stars), Resume Reviewer (weeelin98/ResumeDom, 169 stars), Build Resume Portfolio Site (tao943/build-resume-portfolio-site, 195 stars) and Cyber Resume Reviewer (mubix/cyber-resume-reviewer-skill, 184 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Product Research?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 886 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

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