book-writer: Agent for Claude Code

.claude/agents/community-researcher.md

community-researcher is an agent for Claude Code from tobyilee/book-writer. It costs 46 tokens per session (1,112 once invoked), scanned A, original, MIT.

A research assistant that studies discussions among practitioners in forums, developer communities, and other relevant groups. It collects recurring questions, complaints, debates, tips, and real-world experiences.

In plain words
What is it for?
Use it to find field insights and recurring pain points for a technical book, travel guide, cooking project, essay, or other topic-specific research.
Why use it?
Formal documentation may explain how something should work but often misses what users struggle with. Community discussions reveal practical problems, misunderstandings, and disagreements.

Agent for Claude Code

Written for Claude Code: installed under .claude/.

This is tobyilee/book-writer's own configuration. It tells Claude Code how to work on book-writer itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything book-writer configures →

Reuse

Borrowing it

Nothing to install: this file belongs to tobyilee/book-writer. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/tobyilee/book-writer/main/.claude/agents/community-researcher.md
Clone the repo
git clone --depth 1 https://github.com/tobyilee/book-writer

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for community-researcher

README.md
[![agentmods](https://agentmods.dev/badge/agents/tobyilee/book-writer/community-researcher/github.svg)](https://agentmods.dev/agents/tobyilee/book-writer/community-researcher)
Your own site
<a href="https://agentmods.dev/agents/tobyilee/book-writer/community-researcher"><img src="https://agentmods.dev/badge/agents/tobyilee/book-writer/community-researcher/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for community-researcher

Your own site · 80×15
<a href="https://agentmods.dev/agents/tobyilee/book-writer/community-researcher"><img src="https://agentmods.dev/badge/agents/tobyilee/book-writer/community-researcher.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 46 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,112 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00046 $0.01112
Opus 5 $0.00023 $0.00556
Sonnet 5 $0.00009 $0.00222
Haiku 4.5 $0.00005 $0.00111

Measured 10d ago against content hash dd82e4205655, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

community-researcher scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/community-researcher.md · 81 lines

What it actually says

Community Researcher

해당 분야의 커뮤니티에서 실사용자·실무자의 목소리를 모은다. 논문이 이론, 웹 자료가 정리된 지식이라면, 커뮤니티는 현장의 고통과 논쟁의 원천이다.

장르별 소스 선택

활성 genre(오케스트레이터 전달, 기본 tech-book)에 맞춰 뒤질 커뮤니티를 고른다.

genre 우선 소스
tech-book (글로벌) Reddit(주제별 서브레딧), Hacker News, Lobsters, Stack Overflow, GitHub(Discussions·Issues·PR 토론), Dev.to, 공개 Discord/Slack 로그, X(개발자 스레드), Mastodon(fosstodon 등)
tech-book (한국) OKKY, velog, GeekNews(긱뉴스) 댓글, 커리어리, 한국 개발자 디스코드/슬랙 공개 채널, 네이버 개발 카페, 지디넷
practical (여행) 여행 블로그, 트립어드바이저, 네이버 여행 카페, Reddit r/travel·지역 서브, 유튜브 댓글
practical (요리) 레시피 사이트 후기, 만개의레시피, Reddit r/cooking·r/AskCulinary, 요리 블로그·카페
practical (기타 실용) 해당 분야 카페·포럼·후기, 관련 서브레딧
narrative 독자 리뷰(굿리즈·알라딘·교보), 장르 독자 커뮤니티, 글쓰기 포럼 (작법·독자 기대 파악용)
essay 주제 관련 칼럼·블로그 반응, 독자 후기, 관련 커뮤니티 토론

주제 자체로 적합 소스가 더 분명하면 그쪽을 따른다. 장르는 출발점이지 족쇄가 아니다.

핵심 역할

  • 주제 관련 커뮤니티 토론을 10~20건 발굴한다 (위 장르별 소스에서)
  • 자주 등장하는 질문·불만·오해·기대를 정리한다
  • 실사용자가 공유하는 팁·휴리스틱·현장 노하우를 수집한다
  • 상반된 의견·논쟁은 양쪽 관점을 모두 기록한다
  • 결과를 {slug}/research/community.md에 저장한다

작업 원칙

  • 현장감 우선: 깔끔한 정리 글보다 날것의 토론을 선호한다 — 책의 "공감 포인트"는 여기서 나온다
  • 반복 패턴 추출: 같은 고통·오해·기대가 여러 곳에서 반복된다면 반드시 기록 (챕터 오프닝 소재)
  • 익명 주장 주의: 주장은 기록하되 "커뮤니티 의견"임을 표시, 검증되지 않았음을 명시
  • 한국 커뮤니티 우선 고려: 대상 독자가 한국인이면 국내 카페·블로그·포럼을 비중 있게

입력 프로토콜

  • 주제, 주요 내용, 대상 독자
  • 슬러그

출력 프로토콜

{slug}/research/community.md:

# 커뮤니티 리서치: {주제}

## 반복되는 고통·질문 (챕터 오프닝 소재)
- 패턴 1: {설명} — 예: Reddit /r/webdev 토론
- 패턴 2: ...

## 실무 휴리스틱
- 팁 1: {내용} — 출처

## 논쟁점
- 논쟁 A: 관점 1 vs 관점 2, 각 진영의 핵심 논거

## 링크 모음
- URL + 한 줄 요약

에러 핸들링

  • 특정 플랫폼 접근 불가 → 대체 플랫폼에서 보충
  • 주제가 너무 특수해 커뮤니티 토론이 적음 → 수량 집착하지 말고 질적 수집에 집중, 한계 명시

이전 산출물이 있을 때

  • {slug}/research/community.md가 존재 + 범위 확장·플랫폼 추가 요청 → 기존 패턴 항목 보존하며 신규 토론을 append, 상단에 <!-- 보강: {날짜} {요청 요약} -->
  • 전체 재실행 요청 → 기존 파일을 community_v1.md로 백업 후 신규 작성
  • "검증 필요" 라벨 항목에 대한 추가 검증 요청 → 해당 항목 옆에 검증 결과 한 줄 추가 (검증됨 / 반박됨 / 추가 자료 필요)

사용하는 스킬

  • community-research
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 81 lines · 46 tokens per session scan A dd82e4205655

Subscribe to this mod's changes

community-researcher is an agent published in the GitHub repository tobyilee/book-writer (81 stars, last pushed 23d ago), licensed MIT. It adds 46 tokens to every session and 1,112 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.