Pain Miner

Evidence-driven community pain research for product discovery. Runs public Reddit, Hacker News and V2EX collection; profiles communities, labels intent and relevance, and renders a source-linked nine-section report. Use for pain mining, user research, community evidence, micro-SaaS discovery, or product opportunity validation.

13 stars 4 forksResearch & Science

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add AdvancingTitans/pain-miner --skill pain-miner
Manual install
git clone --depth 1 https://github.com/AdvancingTitans/pain-miner.git /tmp/pain-miner
mkdir -p ~/.claude/skills
cp -r /tmp/pain-miner/. ~/.claude/skills/pain-miner

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Pain Miner

**输入**:一句目标用户描述。
**最终输出**:九节、来源可追溯的研究报告;不是旧式 `Step A/B/C` 交付。

默认路径免登录。Reddit、HN、V2EX 的可用性取决于网络环境,工具会把失败和样本边界写入结果。

## 标准工作流

```bash
python3 scripts/pain_miner.py diagnose --out /tmp/pain-diagnose.json

python3 scripts/pain_miner.py run \
  --target "独立 SaaS 创业者" \
  --hours 336 --min-score 10 --min-comments 5 \
  --profile-communities --fetch-comments --analyze \
  --out /tmp/pain-run.json

python3 scripts/pain_miner.py render-report \
  --input /tmp/pain-run.json --out /tmp/pain-report.md
```

先读 `/tmp/pain-report.md`,再在其中已有证据范围内补充写作;不要手工将 JSON 重组为流程型标题。

`run --analyze` 在主证据不足时仍会写 JSON,但返回码为 `2`,并将 `analysis.evidence_verdict.status` 置为 `INSUFFICIENT_EVIDENCE`。这不是“没有痛点”的结论,而是当前采样不能支持机会判断。

## 运行前:目标与社区计划

```bash
python3 scripts/pain_miner.py plan-communities \
  --target "独立 SaaS 创业者" --profile-communities \
  --out /tmp/pain-plan.json
```

- 检查 `reddit_subs`、`hn_queries`、`v2ex_nodes` 与 `confidence`。
- 中文目标出现 `SaaS`、`indie`、`独立开发` 等线索时必须保持 `languages: [zh, en]`;不得因中文输入而把英文社区和 HN 排除。
- SaaS/独立开发默认优先 `SaaS`、`indiehackers`、`SideProject`、`EntrepreneurRideAlong` 与 V2EX `create/share`;`career` 只能是显式补充,不得作为主证据。
- 推断不对时用 `--subs`、`--hn-query`、`--v2ex-node` 覆盖,并在报告范围中说明。

## 数据源健康与降级

先运行 `diagnose`,检查 `source_health`:

| 状态 | 动作 |
|---|---|
| `ok` | 正常收集;仍需按相关性和证据类型过滤。 |
| `degraded` | 记录原因,扩大窗口或调整阈值,不把 0 hit 解读为无需求。 |
| `unavailable` / `reddit_edge_block` | 不重复请求同一 Reddit 路径;转 HN-first,并把故障写入报告。 |
| `rate_limited` | 停止重试该源,遵守退避与间隔。 |
Read the full skill on GitHub

Details

Skill name
pain-miner
License
MIT
Repo updated
11 July 2026

FAQ

What does the Pain Miner skill do?

Evidence-driven community pain research for product discovery. Runs public Reddit, Hacker News and V2EX collection; profiles communities, labels intent and relevance, and renders a source-linked nine-section report. Use for pain mining, user research, community evidence, micro-SaaS discovery, or product opportunity validation.

How do I install the Pain Miner skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add AdvancingTitans/pain-miner --skill pain-miner. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Pain Miner popular?

It lives in AdvancingTitans/pain-miner, which has 13 GitHub stars and 4 forks.

Related skills

Research

15

hec-ovi/research-skill

Answers research questions - best X, compare A vs B vs C, what's the latest Y, evaluate this tool, how does Z work. Prefer this over a plain web-search skill for those questions: it searches the web itself and saves the findings. Recalls prior findings from the project's persistent .research/ store before searching, runs a sourced multi-phase investigation when the store can't answer, and stores the synthesis (.research/ with an INDEX.md dispatcher and per-topic FINDINGS.md entries) so the next session skips the re-research.

Research & Science

Embodied AI Paper Writer

15

OpenGHz/embodied-ai-paper-writer

Professional embodied-AI paper-writing coach distilled from 63 top-conference papers (CoRL, RSS, ICRA, IROS, Science Robotics, 2022–2026). Teaches writing craft only — vocabulary, sentence patterns, paragraph flow, figure/table conventions, section-by-section construction, rhetorical pivots, appendix norms. NOT a content advisor: teaches HOW to write, not WHAT to claim. Use when the user mentions writing or reviewing any paper section (abstract, intro, method, related work, experiments, results, ablations, conclusion, limitations, appendix), titling, figure captioning, paragraph polishing, reb

Research & Science

Paper Review

16

jam-cc/paper-review.skill

Review ML/AI research papers, critique contributions and experiments, write referee reports, or self-review before submission. Use for requests such as 'review this paper', 'what are the weaknesses', 'help me referee', '审稿', '写审稿意见', '评审这篇论文', '帮我审', or '投稿前自审'. Also use to improve an existing review or verify its references.

Research & Science

Visual Research

11

curious-endeavor/visual-research

This skill should be used when analyzing a competitor's brand identity, auditing visual brand elements, researching brand positioning, comparing brand aesthetics, evaluating competitor design language, or conducting systematic visual research on brand identity, logo systems, color palettes, or design patterns for competitive analysis. Triggers on: 'research [brand]', 'visual research', 'brand research', 'brand visual audit', 'competitor visual analysis', 'analyze [brand] identity', 'brand audit', 'visual identity analysis', 'find images for [brand]', 'capture [brand] social'.

Research & Science

Academic Revision Checklist

13

JimmyRaoUF/academic-revision-checklist

Reader-first revision of academic English (dissertation chapters, abstracts, papers, defense slides). Finds the sentences a first-time reader stops at, fixes them in the author's voice, and turns each fix into a rule checked across the whole document. 66 checks from 60+ revision rounds of one HCI dissertation, a 16-item quick list, reading protocols, and a script that lists candidates for the mechanical checks. Use when revising or checking academic writing, when a text reads like AI, or when one reader comment should be applied everywhere. 修改或检查英文学术写作(博士论文、摘要、期刊论文、答辩讲稿):找出第一次读的人会卡住的句子,按作者的口吻改

Research & Science

Giasip Research

13

GiaSip/giasip-skills

Use when the user asks to research, investigate, compare competitors, study a market or industry, check the current status of a regulation or policy, search literature, or simply look something up that needs external sources. Any question that requires fetching outside information triggers this skill. To verify specific claims in an existing report, use a dedicated verification pass instead.

Research & ScienceIn 1 list

Browse the most popular Claude skills, all research & science skills, or write your own with the skills generator.