econ-writing-skill: AI 어시스턴트를 경제학 논문 전문가로 변환하는 에이전트 스킬

노벨상 수상자, Clark Medal 수상자 및 주요 경제학자들이 작성한 50개 이상의 권위 있는 가이드를 종합하여, AI 어시스턴트를 전문적인 경제학 논문 작성자로 변환하는 에이전트 스킬 (Agent Skill)입니다.

Econ Writing Skill은 AI 코딩 어시스턴트에게 경제학 논문 작성 방법에 대한 깊은 지식을 제공하는 오픈 소스 에이전트 스킬 (Agent Skill)입니다. John Cochrane, Deirdre McCloskey, Jesse Shapiro, Keith Head, Marc Bellemare, Claudia Goldin, Edward Glaeser, Michael Kremer 등 수많은 경제학자들이 작성한 50개 이상의 가이드에서 실행 가능한 조언을 추출하여 하나의 구조화된 스킬 파일로 정제했습니다. 에이전트 스킬 (Agent Skills) 개방형 표준과 호환되어, Claude Code 및 OpenAI Codex에서 즉시 사용할 수 있습니다.

모든 논문 유형에 적용 가능-- 응용 실증 (Applied empirical), 순수 이론 (Pure theory), 이론-실증 혼합 (Mixed theory-empirical), 구조적 (Structural), 기술적 (Descriptive) 논문 각각에 맞춤화된 구조와 지침을 제공합니다.

모든 주요 섹션을 위한 전용 공식-- 초록 (Abstract, 4단계 공식), 서론 (Introduction, Head의 공식), 모델 섹션 (Model Section, Glaeser/Varian 방식), 데이터 섹션 (Data Section), 결론 (Conclusion, 3단계 공식), 제목 (Title, 평가 기준 포함)

식별 전략 (Identification strategy) 가이드-- 13가지 전략에 대한 구체적인 작성 조언 제공: RCT, DiD (staggered 포함), IV, RDD, Synthetic Control, Synthetic DiD, Bunching, Shift-Share/Bartik, Event Studies, 인과 추론을 위한 머신러닝 (ML for Causal Inference), 구조적 추정 (Structural Estimation), 기술적 (Descriptive) 방식, 그리고 여러 전략을 사용하는 논문에 대한 가이드

이론 논문 지원-- 모델 제시 (Model presentation), 명제 작성 (Proposition writing), 그리고 Glaeser의 "예시로 시작하기 (start with an example)" 접근 방식 지원

분야별 관례 (Field-specific conventions)-- 거시경제학 (Macro: calibration tables, IRFs, DSGE), 무역 (Trade: gravity, PPML), 개발경제학 (Development: CONSORT, cost-effectiveness), 금융 (Finance: Fama-MacBeth, winsorization)

McCloskey와 Cochrane의 스타일 규칙 (Style rules)-- 능동태 (Active voice), 구체적인 언어 (Concrete language), 삼각형 구조 (Triangular structure), 독자 중심의 글쓰기 (Reader-first writing)
안티 AI 글쓰기 패턴 (Anti-AI writing patterns)-- AI 생성 글쓰기의 특징(금지어, 균일한 문장 길이, 일반적인 문구)을 제거하고 실제 경제학자처럼 작성하기
제목 평가 프레임워크 (Title evaluation framework)-- 명확성, 구체성, 길이, 기억 용이성을 기준으로 제목 점수 산정 (좋은 예/나쁜 예 포함)
인용 무결성 (Citation integrity)-- 참고문헌 검증을 위한 환각 방지 (Anti-hallucination) 가이드, 워킹 페이퍼 (Working paper)와 출판된 버전의 구분
경제적 유의성 프레임워크 (Economic significance framework)-- 계수 (Coefficients)를 의미 있는 단위, 정책 벤치마크, 그리고 간이 계산 (Back-of-envelope calculations)으로 변환
표와 그림의 모범 사례 (Tables and figures best practices)-- 자체 완결적인 캡션 (Self-contained captions), 그림 (Figure) 대 표 (Table)의 트레이드오프, Schwabish (JEP)의 데이터 시각화 방식

논문 리뷰 및 감사 모드 (Paper review and audit mode)-- 100점 만점의 채점 루브릭을 활용한 3인의 리뷰어 피드백 시뮬레이션 (방법론 전문가, 분야 전문가, 글쓰기 비평가)
제출 전 체크리스트 (Pre-submission checklist)-- 내용, 스타일 및 현대적 표준을 다루는 24개 항목의 체크리스트
평가 테스트 스위트 (Evaluation test suite)-- 스킬 출력 품질의 벤치마킹을 위한 13가지 테스트 케이스

직업 시장 논문 (Job market paper, JMP) 가이드-- 제목, 초록 (Abstract), 서론 (Introduction) 다듬기, 길이, 전문성 신호 (Signaling breadth)
연구 제안서 작성 (Grant proposal writing)-- NSF, ERC 제안서 가이드: 실행 가능성 (Feasibility), 예산 정당화 (Budget justification), 타임라인, 결과 제시가 아닌 계획 판매하기
심사위원 답변 가이드 (Referee response guidance)-- 수정 후 재제출 (Revise-and-resubmit)을 위한 항목별 답변 구조
정책 브리프 및 오피니언(Op-ed) 작성-- 쉬운 언어와 구체적인 권고 사항을 사용하여 연구 결과를 비학술적 청중에게 전달
워킹 페이퍼에서 저널로의 전환 (Working paper to journal conversion)-- 편집 전략, 저널별 길이 규정 (AER, AER Insights, REStat), 부록 (Appendix) 구성
학위 논문 구조 (Dissertation structure)-- 3개 에세이 형식, 장 (Chapter) 구조, 저자 규칙
서베이 및 리뷰 논문 작성 (Survey and review paper writing)-- JEL, JEP, 핸드북 (Handbook) 장의 관례
공동 저자 관례 (Coauthorship conventions)-- 문체 일관성, 지정된 "문체 편집자 (Voice editor)", 개인별 기여도 신호 (Signaling individual contributions)

현대적 실증 관행 (Modern empirical practices)-- 사전 등록 (Pre-registration), 다중 테스트 (Multiple testing), 명세 강건성 (Specification robustness), 투명성 및 재현성 (Transparency and reproducibility)
AEA 복제 패키지 표준 (AEA replication package standards)-- 데이터 에디터 (Data Editor) 요구사항: README 템플릿, 데이터 인용 (Data citation), 디렉토리 구조, 코드 재현성 (Code reproducibility)
AI 사용 공개 가이드라인 (AI use disclosure guidance)-- AI 지원 공개를 위한 저널별 정책 (AEA, Econometric Society)
LaTeX 포맷팅 가이드 (LaTeX formatting guide)-- 표 (booktabs, threeparttable), 그림 (Figures), 참고문헌 (Bibliography, natbib), AER/QJE/Econometrica/REStud/JPE 저널 제출 요구사항

단 하나의 명령어로 모든 프로젝트에 전역 설치(Install globally)하세요:

curl -fsSL https://raw.githubusercontent.com/hanlulong/econ-writing-skill/main/install.sh | bash

이 명령은 해당 스킬을 ~/.claude/skills/econ-write/ (Claude Code) 및 ~/.codex/skills/econ-write/ (Codex)에 설치합니다. 설치된 스킬은 모든 프로젝트에서 즉시 사용할 수 있습니다.

AI 어시스턴트를 떠나지 않고도 설치할 수 있습니다. Claude Code에게 다음과 같이 말하세요:

Run this command to install the econ-writing skill globally:
curl -fsSL https://raw.githubusercontent.com/hanlulong/econ-writing-skill/main/install.sh | bash

설치 후 세션을 재시작하세요. 그 다음 /econ-write를 입력하고 수행할 작업을 이어서 작성하면 됩니다.

Codex에게 다음과 같이 말하세요:

Run this command to install the econ-writing skill globally:
curl -fsSL https://raw.githubusercontent.com/hanlulong/econ-writing-skill/main/install.sh | bash

npx skills add hanlulong/econ-writing-skill

git clone https://github.com/hanlulong/econ-writing-skill.git
cd econ-writing-skill
./install.sh # 전역 설치 (기본값)
...

mkdir -p ~/.claude/skills/econ-write
curl -fsSL https://raw.githubusercontent.com/hanlulong/econ-writing-skill/main/.claude/skills/econ-write/SKILL.md -o ~/.claude/skills/econ-write/SKILL.md
curl -fsSL https://raw.githubusercontent.com/hanlulong/econ-writing-skill/main/.claude/skills/econ-write/identification-strategies.md -o ~/.claude/skills/econ-write/identification-strategies.md

git clone https://github.com/hanlulong/econ-writing-skill.git
cp -r econ-writing-skill/.claude/skills/econ-write/ /path/to/your/project/.claude/skills/econ-write/

플래그 (Flag)	동작 (Behavior)
(기본값)	모든 프로젝트에 전역적으로 설치
--local	현재 프로젝트에만 설치
--claude	Claude Code 전용으로 설치
--codex	Codex 전용으로 설치

예시: ./install.sh --local --claude /path/to/project

설치가 완료되면, AI 어시스턴트에서 해당 스킬을 호출하십시오:

/econ-write 최저임금이 고용에 미치는 영향에 관한 내 논문의 서론을 작성해줘

/econ-write 이 초록(abstract)을 더 구체적으로, 150단어 이내로 다시 작성해줘

/econ-write 학교 재정에 관한 나의 RDD(회귀 불연속 설계, Regression Discontinuity Design) 논문의 결론 초안을 작성해줘

/econ-write 이 문단에 스타일 위반 사항이 있는지 검토해줘

/econ-write 내 이론 논문의 모델(model) 섹션 구조를 잡는 것을 도와줘

/econ-write 내 논문 전체를 감사(audit)하고 점수를 매겨줘

이 스킬은 네 가지 모드로 작동합니다:

초안 작성 (Drafting): 공식과 규칙을 따라 새로운 텍스트를 생성하며, 사용자의 구체적인 결과가 필요한 부분은 [AUTHOR: ...] 플레이스홀더(placeholder)로 표시합니다.

다시 쓰기 (Rewriting): 규칙 위반 사항(수동태, 모호한 언어, 핵심 내용이 뒤에 숨겨진 경우, 서론이 너무 긴 경우 등)을 식별하고, 사용자의 의미와 기여도를 보존하면서 이를 수정합니다.

검토 (Reviewing): 기존 텍스트를 모든 규칙에 따라 확인하고, 문제점과 제안된 수정 사항이 포함된 상세 보고서를 제공합니다.

감사 (Auditing): 세 명의 가상 심사위원(reviewer) 관점에서 논문 전체에 점수를 매기고, 우선순위가 지정된 피드백과 함께 100점 만점의 루브릭(rubric)을 반환합니다.

새로운 논문 섹션 초안 작성 (Drafting a new paper section)-- 시작부터 확립된 공식(formulas)을 따르는 모든 섹션(초록, 서론, 데이터, 결과, 결론)의 첫 번째 초안을 생성합니다.

명확성을 위한 기존 텍스트 재작성 (Rewriting existing text for clarity)-- 산문을 다듬고, 수동태를 제거하며, 불필요한 서술(throat-clearing)을 줄이고, 결과를 구체화합니다.

서론을 처음부터 작성하기 (Writing an introduction from scratch)-- Head의 공식을 정확히 따릅니다: 후크(Hook), 연구 질문(Research Question), 주요 결과(Main Results), 문헌 검토 및 가치 제안(Literature Review & Value Added), 로드맵(Roadmap).

문헌 검토 수행 및 작성하기 (Conducting and writing a literature review)-- 논문의 틈새 시장(niche)을 설정하기 위해, 서론에 포함될 가장 밀접한 5~10개의 논문을 바탕으로 이야기 중심의 검토를 구축합니다.

기존 실증 결과 정리하기 (Writing up existing empirical results)-- 경제적 유의성(economic significance)에 적절히 강조를 두면서, 올바른 순서(주요 결과를 먼저, 가장 간결한 것에서 가장 복잡한 순으로)로 결과를 제시합니다.

이론 논문 작성하기 (Writing a theory paper)-- 모델 제시 구조를 잡고, 증명(proofs) 이전에 직관(intuition)과 함께 명제(propositions)를 작성하며, 검증 가능한 예측(testable predictions)을 생성합니다.

이론-실증 혼합 논문 구조화하기 (Structuring a mixed theory-empirical paper)-- 실증 테스트를 특정 모델 예측과 다시 연결(map)합니다.

발표 준비하기 (Preparing a presentation)-- Shapiro, Cochrane 등의 방식을 따라 슬라이드 구조, 속도 조절, 전달 방식에 대한 조언을 얻습니다 (

핵심 원칙 (Core Principles)-- 7가지 기초 규칙 (독자 우선 (Reader First), 삼각형 스타일 (Triangular Style), 하나의 핵심 기여 (One Central Contribution), 추상적이지 않게 구체적으로 (Concrete Not Abstract), 모든 단어의 중요성 (Every Word Counts), 능동태 (Active Voice), 복잡함보다 단순함 (Simple over Complex))

섹션 공식 (Section Formulas)-- 초록 (Abstract), 서론 (Introduction, Head의 공식), 모델 섹션 (Model Section, Glaeser/Varian 방식), 데이터 섹션 (Data Section), 결론 (Conclusion, 3단계 공식), 그리고 제목 (Title, 평가 기준 포함)에 대한 단계별 공식

스타일 규칙 (Style Rules)-- 문장 구조, 단어 선택, 태 (voice), 대명사, 각주, 숫자, 표기법 (notation), 단락, 그리고 AI 작성 패턴 방지에 대한 상세 가이드

표와 그림 (Tables and Figures)-- 캡션 (captions), 서식 (formatting), 그림과 표의 트레이드오프 (trade-offs), 그리고 데이터 시각화에 관한 모범 사례

실증 연구 규칙 (Empirical Work Rules)-- 식별 (identification), 결과 제시, 무효 결과 (null results), 이질성 분석 (heterogeneity analysis), 메커니즘 (mechanisms), 그리고 흔한 실수들

현대적 실증 관행 (Modern Empirical Practices)-- 사전 등록 (Pre-registration), 다중 테스트 (multiple testing), 명세 강건성 (specification robustness), 투명성 (transparency)

논문 구조 템플릿 (Paper Structure Templates)-- 응용 (applied), 이론 (theory), 이론-실증 혼합 (mixed theory-empirical), 그리고 구조적 (structural) 논문을 위한 템플릿과 부록 (appendix) 구성 가이드

유즈케이스 지침 (Use Case Instructions)-- 초안 작성 (drafting), 재작성 (rewriting), 검토/감사 (reviewing/auditing), 서론 (introductions), 문헌 검토 (literature reviews), 초록 (abstracts), 결론 (conclusions), 결과 (results), 이론 논문 (theory papers), 데이터 섹션 (data sections), 발표 (presentations), 그리고 심사위원 답변 (referee responses)에 대한 구체적인 지침

수정 체크리스트 (Revision Checklist)-- 내용, 스타일, 그리고 현대적 기준을 포괄하는 제출 전 24개 항목 체크리스트

분야별 관례 (Field-Specific Conventions)-- 거시경제학 (macro), 무역 (trade), 개발 (development), 그리고 금융 (finance) 분야를 위한 조정 사항

AEA 재현 표준 (AEA Replication Standards)-- 재현 패키지 (replication packages), 데이터 인용 (data citation), 그리고 AI 공개 (AI disclosure)에 대한 데이터 에디터 (Data Editor) 요구 사항

학위 논문 구조 (Dissertation Structure)-- 3개 에세이 형식 (Three-essays format) 및 JMP (Job Market Paper) 포지셔닝

각 식별 전략(Identification Strategy)에 맞춤화된 상세한 글쓰기 가이드: RCT, DiD, IV, RDD, 합성 대조법 (Synthetic Control), 구조적 추정 (Structural Estimation), 기술/측정 (Descriptive/Measurement), 번칭 추정 (Bunching Estimation), Shift-Share/Bartik 도구 변수 (Instruments), 사건 연구 (Event Studies), 그리고 인과 추론을 위한 머신러닝 (Machine Learning for Causal Inference). 12가지 논문 유형에 따라 도입부의 후크 (hooks), 결과 단락, 그리고 주요 위협 요소 (key threats)를 어떻게 조정해야 하는지 보여주는 서론 조정 표를 포함합니다.

경제학 논문을 위한 실무적인 LaTeX 가이드: 문서 구조, 필수 패키지 (booktabs, threeparttable, natbib, siunitx), 회귀 분석 표 (regression table) 포맷팅, 그림 (figure) 베스트 프랙티스 (PDF 벡터 그래픽, subfigures), 참고문헌 관리, 수학식 포맷팅, cleveref를 이용한 상호 참조 (cross-referencing), 학술지 제출 요구 사항 (AER, QJE, Econometrica, REStud, JPE), Beamer 발표 자료, 그리고 흔히 발생하는 실수들.

구조화된 논문 리뷰 프레임워크: 퀵 스캔 모드 (5분 체크), 심층 리뷰 모드 (3명의 시뮬레이션 리뷰어: 방법론 전문가, 분야 전문가, 글쓰기 비평가), AI 탐지 방지 체크리스트, 제출 전 100점 만점 채점 루브릭, 그리고 Top-5 저널 대 분야별 저널 타겟팅을 위한 학술지 적합성 평가.

이 스킬은 **50개 이상의 권위 있는 출처 (authoritative sources)**의 조언을 종합합니다. 권위와 영향력에 따른 상위 10개 출처는 다음과 같습니다:

순위	출처	저자	소속
1	Writing Tips for Ph.D. Students	John H. Cochrane	U Chicago Booth / Hoover
...

주요 권위자로는 노벨상 수상자 (Goldin 2023, Kremer 2019), Clark Medal 수상자 (Shapiro 2022), 그리고 주요 학술지 편집자들 (AJAE의 Bellemare, AJAE의 Beatty, JEEM의 Shimshack)이 포함됩니다.

링크, 티어(tier), 노트를 포함한 50개 이상의 모든 출처에 대한 전체 순위 목록은 sources/SOURCES_RANKED.md에서 확인할 수 있습니다.