Communitygithub.com

shimo4228/claude-skill-paper-ecosystem

학술 논문(SSRN / arXiv / Zenodo / 저널) 작성 및 리뷰를 위한 Claude Code 에이전트 스킬 번들입니다. 오케스트레이터 스킬, 초안 스킬, 5개 리뷰어 서브에이전트를 포함하며, install.sh를 통해 스킬과 에이전트를 함께 패키징한 최초의 레포지토리입니다.

claude-skill-paper-ecosystem란 무엇인가요?

이 스킬은 Claude Code에서 학술 논문(포지션 페이퍼, 프리프린트, 저널 스타일)을 체계적으로 작성할 수 있도록 지원하는 스킬 번들입니다. `paper-ecosystem` 오케스트레이터의 규칙을 따르며, 초안 작성 전에 저자가 프라이머리 소스 목록 확립, 용어집 의존 회피, 클레임-인용 1:1 매핑, 하위 분류 보존 등 사전 점검을 완료해야 합니다. 논문은 9개 섹션 템플릿(제목 페이지, 초록, 서론, 본문, 기존 프레임워크와의 관계, 결론, 참고문헌 등)을 따르며, 초록은 3단 구조(250-300단어)로 작성됩니다. 각 섹션 초안 완료 후 `paper-reviewer`, `source-fidelity-checker`, `vocabulary-consistency-checker` 에이전트를 병렬로 실행하여 검토하며, 최종 제출 전 품질 게이트(모든 체크 통과, 인용 일관성, 초록 단어 수 등)를 통과해야 합니다. 다중 언어 버전 작성 시 영어를 원본으로 하고 파일명에 언어 코드를 추가하며, 기술 용어는 원어를 유지합니다. 주요 대상 플랫폼은 SSRN, arXiv, Zenodo, 학술 저널이며, 블로그 포스트나 프로젝트 문서에는 다른 전용 스킬을 사용합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/claude-skill-paper-ecosystem

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

paper-writing — 학술 논문 초안 작성 절차

포지션 페이퍼 / 프리프린트 / 저널 스타일 논문의 초안 작성 절차를 paper-ecosystem 오케스트레이터의 정본 규칙에 따라 조직화하는 스킬입니다.

활성화 시점

  • SSRN / arXiv / Zenodo / 저널 게재처용 논문을 초안할 때
  • 기존 에세이 연작 / ADR 묶음 / 구현 이력에서 논문을 추출할 때
  • 포지션 페이퍼의 개요 확정 후 각 섹션 초안 작업에 들어갈 때
  • 프리프린트 v1 → v2 개정(중대한 재작성을 수반하는 경우)

활성화 제외

  • 블로그 포스트 / 에세이(인간 주체, 비격식) → writing-ecosystem 사용
  • llms.txt / FAQ(AI 주체) → llms-txt-writer 사용
  • README / CHANGELOG(프로젝트 문서) → 스킬을 거치지 않고 직접 작성

초안 전 점검 목록

논문 초안에 들어가기 전, 저자는 다음을 완료해야 합니다:

1. 프라이머리 소스 목록 확립

논문이 인용할 프라이머리 소스를 목록화합니다:

  • 인용할 에세이 / 블로그 포스트 (URL + 날짜 + 1줄 요약)
  • 인용할 ADR / 스펙 문서 (레포지토리 경로 + 버전 + 1줄 요약)
  • 인용할 외부 논문 (저자 연도 + arXiv ID / DOI + 1줄 요약)
  • 인용할 표준 / 프레임워크 문서 (기관 연도 + 표준 ID)

각 프라이머리 소스는 논문 초안 시 직접 읽을 수 있는 상태여야 합니다(URL 접근 가능, 레포지토리 클론 완료, PDF 확보 완료).

2. 용어집 / 요약에 의존하는 것을 피함

프라이머리 소스 대신 레포지토리의 용어집 / 요약 / 2차 문서를 인용 출처로 참조하지 않습니다. 2차 문서의 표류(drift)가 논문에 전파되기 때문입니다(자세한 내용: paper-ecosystem 스킬의 소스 충실도 규칙).

2차 문서를 참조하는 경우는 다음 두 가지뿐입니다:

  • 용어 정의 일관성 검증(논문의 정의와 용어집의 정의가 일치하는지 확인)
  • 참고문헌 목록 형식 참조(어떤 필드를 포함할지 스타일 예시)

3. 주장 ↔ 인용 출처의 1:1 매핑

개요 단계에서 각 섹션의 핵심 주장을 한 문장으로 작성하고, 각 주장에 대응하는 인용 출처를 1:1로 매핑합니다. 매핑이 불명확한 주장은 초안에 포함하기 전에 해결합니다.

형식 예시:

§3 핵심 주장: "리디렉션 실패에는 두 가지 구조적으로 구별되는 유형이 있다 — 원칙적인(자율 루프에 내재된) 것과 인위적인(워크플로우 작업이 자율 루프를 통해 라우팅되는 것)."
인용 출처:
- 에세이 5 (zenn-content/articles-en/react-agent-business-quadrant-2.md, 2026-04-30)
- ADR-0009 §Context (agent-attribution-practice/docs/adr/0009-triage-before-autonomy.md)
- Elish (2019) "Moral Crumple Zones"

4. 하위 분류의 보존

프라이머리 소스가 개념에 하위 형태 / 하위 셀 / 하위 유형을 부여한 경우, 논문의 용어 도입 시 이를 명시합니다. 평탄화(flattening)는 표류(drift)를 유발합니다(자세한 내용: paper-ecosystem 스킬의 어휘 일관성 규칙).


섹션 템플릿 (포지션 페이퍼 / 프리프린트)

표준 9개 섹션 구조:

  1. 제목 페이지 — 제목 + 부제목 + 저자 + ORCID + 버전 + 동반 레포지토리 + 라이선스
  2. 초록 — 250-300단어, 3단락 구조(아래 참조)
  3. 서론 — 문제 제기 + 논제 개요 + 섹션 로드맵
  4. [본문 섹션] — 논문의 핵심 기여. 약 3-6개 섹션
  5. 기존 프레임워크와의 관계 — 짧게(1단락~1페이지), 경쟁 프레임워크와의 관계
  6. 결론 — 논제 재진술 + 미해결 질문
  7. 참고문헌 — APA 단순화 형식
  8. 감사의 글 (선택)
  9. 부록 (선택)

저널 스타일 논문에서는 게재처의 하우스 스타일에 따라 섹션 번호 / 제목 계층 / 표 및 그림 배치를 조정합니다.


초록 구조 (250-300단어)

3단락:

  1. 문제 제기 (~70-90단어) — 어떤 현상을 다루며, 현재 담론에서 무엇이 부족한가
  2. 기여 (~120-150단어) — 논문의 핵심 기여 2-3개를 명시. 각 기여에 대해 무엇을 / 왜 / 어떻게 각각 한 문장씩
  3. 결과 (~60-90단어) — 기여가 논문의 독자에게 무엇을 가져다주는지, 미해결된 열린 질문에 대한 언급

키워드 (5-8개)를 초록 바로 아래에 배치합니다.


참고문헌 형식 (APA 단순화)

출처 유형형식
저널 논문저자, A. B. (연도). 제목. *저널명* 권(호): 페이지.
arXiv 프리프린트저자, A. B., & 저자, C. D. (연도). *제목.* arXiv:NNNN.NNNNN.
학술대회 논문저자, A. B. (연도). 제목. In *학술대회명* (페이지). 출판사.
산업체 / 기업 문서기관명. (연도). *제목.* URL
표준기관명. (연도). *표준 ID 제목.* 출판사.
레포지토리 / 데이터셋저자, A. B. (연도). *제목 (버전).* 플랫폼. DOI

자세한 내용: paper-ecosystem 스킬의 인용 형식 규칙.


다중 언어 규칙 (선택)

보조 언어판(예: 한국어 번역)을 병행 작성하는 경우:

  • 영어판이 원본(primary), 보조 언어판은 정본이 아님
  • 파일 명명: <논문명>.md (영어) + <논문명>.ja.md (일본어) — 한국어의 경우 <논문명>.ko.md
  • 내용 변경 시 영어판이 먼저, 보조 언어판을 순차적으로 반영
  • 기술 용어 (Quadrant / Phase Separation / artifact name 등)는 보조 언어판에서도 영어 표기 그대로, 또는 영어 병기

자세한 내용: paper-ecosystem 스킬의 다중 언어 논문 규칙.


작성 과정 (섹션 초안 작업)

각 섹션의 초안 작성 절차:

  1. 섹션 주장을 한 문장으로 작성 (초안 전 점검 목록의 결과물 재확인)
  2. 섹션 시작은 구체물로: 예시 / 알려진 현상 / 인용 출처의 인용문, 추상적인 프레이밍으로 시작하지 않음
  3. 주장을 뒷받침하는 증거를 바로 뒤에 배치 (인용과 1:1)
  4. 섹션 전환을 섹션 끝에서 명시: 다음 섹션에 무엇을 넘길지, 현재 섹션의 무엇이 전제로 이어질지
  5. 보조 단락은 주장을 분해하는 방향이거나 반론 / 대안을 처리하는 방향, 둘 중 하나로 통일 (둘 다 섞이면 흐름이 약해짐)

각 섹션 초안 완료 후, paper-reviewer 에이전트 + source-fidelity-checker 에이전트 + vocabulary-consistency-checker 에이전트를 병렬로 실행하여 검토합니다(자세한 내용: paper-ecosystem 스킬의 '언제 무엇을 사용할지' 흐름도).


품질 게이트 (제출 전)

제출 직전에 다음을 확인:

  • 모든 섹션이 paper-reviewer를 통과함
  • 모든 주장이 source-fidelity-checker에서 ALIGNED 또는 PARTIAL 판정 (DRIFT는 잔존하지 않음)
  • 모든 용어가 vocabulary-consistency-checker를 통과함 (하위 분류 도입 명시 완료)
  • citation-formatter에서 고아 인용 0, 인용 ↔ 참고문헌 1:1
  • 초록 단어 수가 게재처 표준 범위 내
  • DOI / arXiv ID / URL이 모두 유효
  • 다중 언어판이 있는 경우 영어판과 내용이 불일치하지 않음

자세한 차원은 paper-ecosystem 스킬 내 4개 표준 규칙 섹션을 참조.


관련 항목

  • paper-ecosystem 스킬 — 소스 충실도 / 어휘 일관성 / 학술적 어조 / 인용 형식의 정본. 본 스킬이 의존하는 오케스트레이터
  • paper-reviewer 에이전트 — 섹션 초안 완료 후 구조 검토
  • source-fidelity-checker 에이전트 — 섹션 초안 완료 후 인용-주장 일관성 검증
  • vocabulary-consistency-checker 에이전트 — 섹션 초안 완료 후 용어 일관성 검증
  • citation-formatter 에이전트 — 제출 직전 인용 ↔ 참고문헌 최종 게이트
  • writing-ecosystem 스킬 — 블로그 포스트 / 에세이용, 본 스킬이 아니라 해당 스킬 사용
  • llms-txt-writer 스킬 — AI 대상 문서용, 본 스킬이 아니라 해당 스킬 사용

관련 스킬