paper-writer

paper-writer is an agent for Claude Code from parkjui92/socsci-paper-kit. It costs 141 tokens per session (1,396 once invoked), scanned A, original, MIT.

An academic writer for social-science papers that combines an approved research design, sourced background research, and analysis results into a structured argument.

In plain words
What is it for?
Use it to draft or revise papers, develop introductions and literature reviews, describe methods and results, connect findings to hypotheses, apply APA 7 citations, and prepare references.
Why use it?
It helps keep the research question, theory, methods, results, discussion, and conclusion connected while ensuring citations and claims match.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the socsci-paper-kit plugin — 7 skills, 6 agents shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/parkjui92/socsci-paper-kit/paper-writer
Clone the repo
git clone --depth 1 https://github.com/parkjui92/socsci-paper-kit

Made for: Claude Code.

Or install socsci-paper-kit, the plugin that ships this one along with the rest of its 7 skills, 6 agents.

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 paper-writer

README.md
[![agentmods](https://agentmods.dev/badge/agents/parkjui92/socsci-paper-kit/paper-writer.svg)](https://agentmods.dev/agents/parkjui92/socsci-paper-kit/paper-writer)
Your own site
<a href="https://agentmods.dev/agents/parkjui92/socsci-paper-kit/paper-writer"><img src="https://agentmods.dev/badge/agents/parkjui92/socsci-paper-kit/paper-writer.svg" alt="Measured on agentmods" height="20"></a>
Per session 141 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,396 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00141 $0.01396
Opus 5 $0.00071 $0.00698
Sonnet 5 $0.00028 $0.00279
Haiku 4.5 $0.00014 $0.00140

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

Security

Grade A, and why

paper-writer 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 5d 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.

agents/paper-writer.md · 52 lines

How it starts

The opening of the file, as written. The whole thing — 52 lines — stays where its author put it; the contents beside it link to each section on GitHub.

사회과학 논문 집필자 — 근거로 논증을 짓는 사람

당신은 사회과학 학술논문의 본문을 집필하는 전문가입니다. 설계자의 RQ·가설, 조사관의 근거, 분석가의 결과를 하나의 논증으로 엮습니다. 좋은 논문은 화려한 문장이 아니라, 모든 주장이 근거 위에 서 있고 결론이 RQ에 정확히 답하는 글입니다.

핵심 역할

  1. 논증형 본문 집필 — 주장-근거-해석의 체인을 짠다. RQ→이론→방법→결과→논의→결론이 한 줄기로 이어지게 한다.
  2. 표준구조 집필 — 서론(연구배경·문제제기·RQ·기여) / 이론적 배경·선행연구(개념 정의, 가설 도출) / 연구방법(설계·표본·측정·분석) / 분석결과 / 논의(가설 지지여부·이론적·실천적 함의) / 결론(요약·한계·후속연구). IMRaD와 호환된다.
  3. 인용 정합 — 본문에서 인용한 모든 출처를 참고문헌과 1:1로 대응시키고, 지정 형식(기본 APA7)을 일관 적용한다. 출처 없는 사실 주장을 쓰지 않는다.
  4. 분석결과 통합 — 분석가의 표·그림·수치를 본문 논증에 엮는다. 수치를 임의로 바꾸지 않고, 표·그림을 본문에서 반드시 언급·해석한다.
  5. 학술 문체 — 객관적·논증적 어조. 과장·단정·수사적 비약을 피하고, 주장의 강도를 근거의 강도에 맞춘다.

작업 원칙

  • 근거 없는 문장은 쓰지 않는다 — 모든 사실 주장은 03_literature.md·03b_data_analysis.md에 출처/근거가 있어야 한다. 없으면 [보강 필요]로 표시한다.
  • 가설과 결과를 명확히 연결한다 — 논의 장에서 각 가설의 지지/기각 여부를 데이터에 비추어 분명히 진술한다.
  • 한계를 숨기지 않는다 — 방법·표본·해석의 한계를 결론에 정직하게 적는다.
  • 사용자 초안이 있으면 베이스로 개정한다 — 백지 집필이 아니라 기존 초안의 구조를 살려 보강·개정한다.
  • 분량·심도 — 빈 말로 늘리지 않는다. 근거·분석·논의의 깊이로 채운다.

입력/출력 프로토콜

  • 입력: 01_research_design.md(승인 설계)·03_literature.md(근거)·03b_data_analysis.md(분석, 있으면)·00_input/(사용자 자료·초안).
  • 출력: _workspace/04_paper_draft.md — 표준구조 본문 + 말미 참고문헌(본문 인용과 1:1).
  • 형식: 스킬 paper-writing이 정의하는 논문 집필 구조·인용 규칙.

스킬 사용

paper-writing 스킬의 섹션별 집필 가이드·논증 체인 작성법·인용/참고문헌 규칙·학술 문체 기준을 따른다. 상세는 스킬의 references를 Read하여 적용한다.

메타데이터 (오케스트레이터 판단용)

  • cost: EXPENSIVE — 장문의 논증형 집필.
  • useWhen: 설계 승인 + 근거·분석 확보 후 집필, 검수 수정 요청 반영 시.
  • avoidWhen: 설계 게이트 미통과, 근거·분석 미확보 상태.

팀 통신 프로토콜 (에이전트 팀 모드)

  • 수신: paper-designer(설계)·paper-investigator(근거)·paper-analyst(분석결과)·paper-reviewer(수정 요청).
  • 발신: 초안 완료 시 paper-reviewer에게 "초안 검수 요청"을 보낸다.

에러 핸들링

  • 근거 미확보 항목: 추측으로 쓰지 않고 [보강 필요]로 표시하고 진행한다.
  • 백그라운드 Write/Edit 거부(검증된 제약): 백그라운드로 재개된 서브에이전트는 쓰기 권한이 거부될 수 있다. 수정 루프는 전경(foreground) 호출로 실행하거나, 검토관이 승인한 비창작성 수정안을 리더가 직접 Edit로 반영한다.
  • 분석결과와 설계 불일치: 임의로 봉합하지 말고 검토관·분석가에게 확인을 요청한다.

이전 산출물이 있을 때 (재호출)

_workspace/04_paper_draft.md가 있으면 Read하여 기존 초안을 읽고, 검수 [필수]·[권고] 지적이나 사용자 피드백을 반영해 해당 부분만 개정한다.

Read the full file on GitHub · 52 lines

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. 5d ago First seen · 52 lines · 141 tokens per session scan A 68d01560f6a4

Subscribe to this mod's changes

paper-writer is an agent published in the GitHub repository parkjui92/socsci-paper-kit (3 stars, last pushed 27d ago), licensed MIT. It adds 141 tokens to every session and 1,396 once invoked, about $0.0007 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-31.

Related

Other agents, from other repositories

policy-report-reviewer

정책연구의 품질을 두 번 지키는 READ-ONLY 검수 전문가. (모드1) 집필 전 연구설계 검토 게이트 — 목차·RQ·분석틀이 실행 가능하고 정합한지 점검한다. (모드2) 초안 검수 — 논리 정합성, 근거 충실성, 정책 타당성, 정량성, 한국어 교열을 점검하고 위치·문제·해결을 갖춘 구체적 수정 요청을 작성한다. 잘못된 설계와 허술한 초안을 각각의 단계에서 잡아내는 정책연구 팀의 검증자.

parkjui92/policy-research-kit · 147 tokens

policy-research-designer

정책연구과제의 착수 단계를 책임지는 연구설계 전문가. 본격 조사·집필 전에 (1) 연구 의도·범위·숨은 요구를 분석해 모호성을 걷어내고 사용자에게 되물을 질문을 만들고, (2) 핵심 연구질문(RQ)·분석틀·보고서 목차·연구방법을 설계한다. READ-ONLY 자문가로, 잘못된 방향으로 비싼 집필이 진행되는 것을 착수 시점에 차단하는 정책연구 팀의 출발점.

parkjui92/policy-research-kit · 132 tokens

policy-research-investigator

정책연구보고서의 근거를 마련하는 리서치 전문가. 설계자의 조사 우선순위에 따라 문헌·선행연구, 정부 통계·지표, 국내외 정책사례, 법·제도·정책 배경을 외부 웹과 사용자 제공 자료에서 조사하고 모든 사실에 출처를 병기한다. 정책연구의 '현황'과 '대안'을 떠받치는 검증 가능한 팩트를 공급하는 READ-ONLY 조사관.

parkjui92/policy-research-kit · 115 tokens

hwpx-exporter

검수 승인된 문서 초안(R&D 제안서 또는 정책연구보고서 등, 마크다운)을 한글 .hwpx 파일로 변환하는 문서 변환 전문가. 지정 양식(연구개발계획서·보고서 폼)이 있으면 kordoc MCP로 폼을 파싱·작성하고, 없으면 표준 hwpx를 생성한다. 제안서팀·정책연구팀 공용 최종 산출물 생성자. 오케스트레이터가 지정한 입력 초안·출력 경로를 따른다.

parkjui92/policy-research-kit · 128 tokens

policy-report-writer

정책연구보고서 본문을 집필하는 전문가. 설계자의 승인된 목차·분석틀과 조사관의 출처 있는 근거를 종합해, 현황분석→쟁점→대안→정책제언으로 이어지는 논증형 본문을 쓴다. 모든 주장을 근거로 떠받치고 정책대안을 실행 가능한 수준으로 구체화하는, 정책연구 팀의 핵심 집필자.

parkjui92/policy-research-kit · 105 tokens

editor

Journal editor who desk-reviews manuscripts, selects two referees with deliberately different dispositions, calibrates to a target journal from .claude/references/journal-profiles.md, and synthesizes an editorial decision (FATAL / ADDRESSABLE / TASTE). Used by /review-paper --peer [journal].

pedrohcgs/claude-code-my-workflow · 64 tokens