AI Research Skills
- 추천0
- GitHub 별667
- 문서라이선스MIT
문헌 탐색부터 연구 설계 · 논문 작성까지 연구 전 과정을 17개 스킬로 돕는 연구 워크플로 카탈로그. MIT
요약
문헌 탐색부터 연구 설계 · 논문 작성까지 연구 전 과정을 17개 스킬로 돕는 연구 워크플로 카탈로그. MIT
설명
AI Research Skills
💡 수직(Vertical) AI 연구 참조 하네스를 위한 카탈로그 · 설치 · 시각 계층입니다. 연구 방향 잡기부터 릴리스까지, 이식 가능한 17개 스킬, 8단계 생애주기, 근거를 의식한 인수인계, 명시적인 사람 승인 지점을 거쳐 나아갑니다.
블랙박스 대신 점검할 수 있는 연구 워크플로가 필요한 대학원생, 박사과정생, 박사후 연구원, 연구 지원 인력, 에이전트/하네스 개발자를 위해 만들었습니다. 이식 가능한 스킬은 이 저장소에 있고, research-hub가 실행 가능한 런타임을 제공하며, 선택 사항인 agent-collab-harness가 정책/체크포인트 거버넌스를 더합니다.
언어: English | 繁中 · 파이프라인 · 예시 · 런타임 계약 · 용어집 · 에이전트/하네스 개발자를 위한 안내
📚 에이전틱 AI 학습 로드맵의 한 부분이며, 13–14절(연구 워크플로)에 소개되어 있습니다.
여기서 시작 — 왜, 무엇을, 어떻게
연구 생애주기 전체를 먼저 보세요
17개 핵심 스킬은 오래 이어지는 인수인계를 중심으로 짜여 있습니다. 각 단계가 다음 단계의 입력을 만들고, 단계를 가로지르는 도구들이 맥락, 검증, 위임 경계를 지켜 줍니다.
| 첫 번째 질문 | 짧은 답 | 더 자세히 |
|---|---|---|
| 왜 이 스킬을 쓰나요? | 연구 맥락을 오래 보존하고, 주장이 다음 단계로 넘어가기 전에 근거를 확인하고, 의미 있는 사람의 결정 지점에서 자동화를 멈출 수 있습니다. | 이 카탈로그가 해결하는 문제(2절) |
| 무엇이 들어 있나요? | 이식 가능한 스킬 17개, 생애주기 8단계, 설치 가능한 플러그인 5개, 실행 가능한 연구 런타임, 선택 사항인 정책/체크포인트 하네스. | 스킬이 내놓는 결과(5절) |
| 어떻게 쓰나요? | 12개 스킬이 들어 있는 연구 워크스페이스를 설치한 뒤, 구체적인 연구 결과물을 자연어로 요청하세요. 글쓰기, Zotero, 위임 플러그인은 필요할 때만 더하세요. | 30초 설치(1절) · 사용 패턴(4절) |
| 핵심 스킬 17개 | 연구 단계 8개 | 필요에 따라 쓰는 플러그인 5개 | 진실 저장소 연동 3개 |
|---|---|---|---|
이식 가능한 SKILL.md 계약 | 방향 잡기 → 릴리스 | 1개로 시작해 5개까지 | Zotero · Obsidian · NotebookLM |
가장 작은 쓸모 있는 경로로 시작하기
claude plugin marketplace add WenyuChiou/ai-research-skills
claude plugin install research-workspace@ai-research-skills
그런 다음 이런 식으로 요청해 보세요.
Build a literature triage matrix for human-in-the-loop research agents. Verify identifiers, preserve contradictions, and show me the evidence gaps before recommending next steps.
프롬프트만 쓰는 스킬 대신, 실행하고 이어갈 수 있는 워크플로가 필요하다면 pip install research-hub-pipeline을 이어서 실행한 뒤 research-hub setup과 research-hub doctor를 실행하세요. 전체 경로는 설치(1절)에 있습니다.
두 가지 제어 계층 이해하기
하네스 아키텍처 — 의미 작업 주변의 결정론적 제어
research-hub가 연구 도메인 런타임과 복구 가능한 상태를 맡습니다. 역할 에이전트가 의미 작업을 하고, 결정론적 검증기, 근거 계약, 선택 사항인 agent-collab-harness 정책/체크포인트 계층이 무엇이 진행될 수 있는지 통제합니다.
사람 개입(Human-in-the-loop) — 자동화가 멈춰야 하는 곳
읽기 전용이거나 되돌릴 수 있는 단계는 자동으로 계속될 수 있습니다. 계약을 깨는 변경, 스킬 제거, 외부 쓰기, 의미상의 수락, 릴리스 승인은 여전히 명시적인 사람의 결정으로 남습니다.
| 어떤 분이신가요 | 다음에 볼 페이지 |
|---|---|
| 연구자 또는 연구팀 | 위의 빠른 설치 뒤에 여덟 단계 파이프라인(3절)을 따라가세요. |
| 에이전트 또는 하네스 개발자 | 아키텍처, 상태, 사람 개입, 복구, 평가 가이드를 읽으세요. |
| 이식성이나 신뢰 경계를 평가 중 | 호환성(7절), 런타임 계약, 한계(8절)를 검토하세요. |
차례
- 설치 — 스킬 받기
- 이 카탈로그가 있는 이유
- 파이프라인 — 각 단계가 다음 단계에 전달하는 것
- 사용하기
- 각 스킬이 내놓는 결과 보기
- FAQ
- 호환성
- 한계
1. 설치 — 스킬 받기
핵심 자산은 이식 가능한 SKILL.md이며, Claude Code 마켓플레이스 지원은 편의 계층입니다. 쓰는 호스트에 맞는 경로를 고르세요.
| 호스트 | 경로 |
|---|---|
| Claude Code | 아래 마켓플레이스 설치. 자동 트리거와 claude plugin list 확인을 쓸 수 있습니다. |
| Codex CLI / Cursor / Windsurf | 정식 저장소의 SKILL.md를 호스트의 skills/rules 폴더에 넣거나 프롬프트에 그대로 넣습니다. |
| Gemini CLI / 일반 API 클라이언트 | SKILL.md를 프롬프트나 시스템 맥락으로 넣습니다. |
| Hermes | 원본 SKILL.md를 설치합니다. 이 저장소는 literature-triage-matrix에 대해 Hermes 0.13.0에서 스킬 로드를 확인했습니다. |
| OpenClaw | 지원될 때 ~/.openclaw/skills/<이름>/SKILL.md 같은 SKILL.md 폴더 모양을 씁니다. 아직 여기서 릴리스 수준으로 검증되지 않았습니다. |
호스트별 자세한 방법은 docs/install.md → Claude Code 밖에서 이 스킬 쓰기에 있습니다.
Claude Code 가장 빠른 길 — 30초:
claude plugin marketplace add WenyuChiou/ai-research-skills
claude plugin install research-workspace@ai-research-skills
Windows cmd.exe: 명령을 한 줄씩 실행하세요. 플러그인 목록에 research-workspace@ai-research-skills가 보이지 않으면, 붙여 넣기가 첫 줄만 실행했을 가능성이 큽니다. 한 줄짜리 CMD 형식은 docs/install.md를 보세요.
Claude Code에서는 앞의 두 명령이 12개 스킬이 들어 있는 research-workspace 플러그인을 설치합니다. 논문 작성, Zotero 전체 작업, Claude에서 Codex/Antigravity로의 위임이 필요할 때만 선택 플러그인을 추가하세요.
단계별 추가 설치 — 어느 단계에서든 멈추고 가진 것을 쓰세요:
# 1. Marketplace + 12 research-hub skills
claude plugin marketplace add WenyuChiou/ai-research-skills
claude plugin install research-workspace@ai-research-skills
# 2. Manuscript work — outline, drafting, prose and evidence audit, scientific review (14/17)
claude plugin install academic-writing-skills@ai-research-skills
# 3. Zotero CRUD (15/17; enable local API in Zotero desktop first — docs/setup-guide.md §C)
claude plugin install zotero-skills@ai-research-skills
# 4. Multi-CLI delegation (17/17; install codex / agy CLI binaries first)
claude plugin install codex-delegate@ai-research-skills
claude plugin install antigravity-delegate@ai-research-skills
# 5. Literature pipeline automation (Python CLI behind research-hub skills)
pip install research-hub-pipeline
research-hub setup --persona researcher
research-hub doctor
별도의 실제 실행 시험(설치 아님):
이것은 오프라인 설치 확인이 아니라 실제 문헌 워크플로입니다. --no-nlm은 NotebookLM만 끄며, 다른 네트워크 호출, 모델, 쓰기는 끄지 않습니다. 실행하기 전에 실제 실행 사전 점검을 마치고 해당하는 데이터/비용/쓰기 승인을 받으세요.
research-hub auto "agent-based modeling" --max-papers 3 --no-nlm
플러그인 5개를 한 번에 설치하기:
bash scripts/install-all.sh # macOS / Linux / git-bash
pwsh scripts/install-all.ps1 # Windows PowerShell
확인:
claude plugin list
# fastest path: research-workspace@ai-research-skills is ✔ enabled.
# full install: 5 plugins ending in @ai-research-skills are ✔ enabled.
claude plugin list는 Claude Code 마켓플레이스 설치만 확인합니다. Codex, Cursor, OpenClaw, Hermes, 일반 API 클라이언트가 SKILL.md 파일을 불러왔는지는 알려 주지 않습니다. 마켓플레이스로 설치한 플러그인은 ~/.claude/skills/가 아니라 ~/.claude/plugins/cache/... 아래에 있습니다.
플러그인별 자세한 내용: docs/install.md. Python / Zotero / Git을 아직 준비하지 않았다면 docs/setup-guide.md부터 시작하세요. 스킬이 프롬프트 전용인지 Python 런타임이 필요한지 알고 싶다면 docs/runtime-contract.md를 보세요.
저장소를 복제하는 편이 다리다면 (기여자 / 디버깅)
git clone https://github.com/WenyuChiou/ai-research-skills.git
cd ai-research-skills
이 카탈로그는 모노레포가 아니라 레지스트리입니다. 각 플러그인의 소스 코드는 자기 저장소에 있습니다.
github.com/WenyuChiou/research-hub—research-workspace스킬 12개github.com/WenyuChiou/academic-writing-skills— 스킬 2개github.com/WenyuChiou/zotero-skills— 스킬 1개github.com/WenyuChiou/codex-delegate— 스킬 1개github.com/WenyuChiou/antigravity-delegate— 스킬 1개
플러그인을 수정하려면 이 카탈로그가 아니라 그 플러그인의 소스 저장소를 복제하세요. 이 카탈로그는 marketplace.json, 문서, 이미지 자산, 카탈로그 쪽 CHANGELOG.md만 관리합니다.
2. 이 카탈로그가 있는 이유
AI를 연구에 쓸 때의 어려움은 이미 아실 겁니다. 아래 다섯 가지는 이 카탈로그가 실제로 해결하는 것이지, 슬적 언급만 하는 것이 아닙니다.
P1 — "새 AI 세션마다 맥락을 다시 설명하고 있어요"
어제 하던 일을 이어 하려고 새 Claude / ChatGPT 세션을 열면, 모델은 내 연구 질문, 이미 끝낸 실험, 기준선, 지난주에 메웠던 공백에 대해 아무것도 모릅니다. 앞의 10분을 그 모든 것을 다시 입력하는 데 씁니다. 내일도 또 같습니다.
P2 — "AI가 존재하지 않는 논문을 자신 있게 인용해요"
모델이 *"Chen et al.(2024)이 보인 바와 같이…"*라고 씁니다. 그 논문은 실제로 존재하지 않습니다. (이번에는) 잡아냅니다. 심사위원 답변에 환각 인용이 있으면 바로 탈락입니다.
P3 — "논문을 50편 읽었는데도 어느 공백이 학위논문 감인지 모르겠어요"
구조화된 답이 필요한 질문이 세 가지 있습니다. (1) 그 공백이 정말 아직 열려 있는가? (2) 메우는 것이 진짜 기여인가, 기존 연구의 순열 조합인가? (3) 내가 가진 시간 안에 메울 수 있는가? 한 문단짜리 「연구 공백 요약」을 내놓는 도구는 이 세 가지 중 어느 것에도 답하지 못합니다.
P4 — "AI가 쓴 글에서 AI 내가 난다"
"Furthermore", "It is noteworthy that", 확실한 주장 없이 모호한 문장들. 심사위원(그리고 시니어 공동 저자)은 두 문단만 읽어도 그 냄새를 알아채고, 원고는 우선순위에서 밀립니다.
P5 — "Claude / Codex / Antigravity를 오가면 내 상태가 사라져요"
Claude로 프롬프트를 설계하고, 코드 뼈대는 Codex에 넘기고, Antigravity는 범위가 정해진 기계적 후속 작업에만 씁니다. 긴 맥락 종합, CJK 작성, 판단, 거버넌스, 최종 검토는 주 모델이 맡습니다. 그래도 인수인계가 명시적이고 오래 가지 않으면 전환할 때마다 다시 적응하는 데 5분이 듭니다.
17개 스킬에 걸쳐 적용한 세 가지 설계 원칙
이 카탈로그는 기능 목록이 아니라 세 가지 핵심 아이디어를 중심으로 짜여 있습니다.
| 원칙 | 하는 일 | 해결하는 문제 |
|---|---|---|
1. 매니페스트(.research/, .paper/) | 연구 상태가 저장소에 들어 있는 YAML / Markdown 파일에 살습니다. 새 AI 세션이 매니페스트를 읽고 스스로 다시 적응합니다 — 맥락을 다시 설명하지 않아도 됩니다. | P1, P5 |
| 2. 누수 방지 규칙이 있는 스키마 | 스킬 사이를 오가는 모든 산출물에 YAML 스키마가 있습니다. evidence_artifacts가 비어 있는 주장은 supported가 아니라 반드시 status: gap + gap_reason을 달아야 합니다(강제). verdict: do-not-pursue인 주제 후보는 worth-pursuing 후보와 구조적으로 분리됩니다. 하류 도구는 과신한 결과물을 내보내기를 거부합니다. | P2, P3, P4 |
| 3. 성격 기반 라우팅 | 토큰을 많이 쓰는 기계적 대량 작업 → Codex. 정직성이 핵심이 아닌 범위가 정해진 기계적 작업 → Antigravity. 긴 맥락, CJK, 판단, 거버넌스, 최종 검토는 주 모델이 맡습니다. 라우터(research-hub-multi-ai)가 조율 파일을 써서, 각 위임 대상이 부모 맥락이 아닌 자기 지시서를 읽게 합니다. | P5 |
위의 8단계 시각 지도는 이 세 원칙이 실제 연구 워크플로에 어떻게 적용되는지 보여 줍니다.
3. 파이프라인 — 각 단계가 다음 단계에 전달하는 것
*"X에 대해 읽어야겠다"*에서 *"원고를 제출했다"*까지 8단계입니다. 각 단계의 출력이 다음 단계의 입력이며, 인수인계는 분위기가 아니라 기계적으로 이뤄집니다.
전체 생애주기에 상태를 가진 컨트롤러 하나가 필요하면 research-workflow-orchestrator를 씁니다. 방향 잡기, 범위 정하기, 탐색, 종합, 설계, 실행, 작성, 릴리스를 조율하고, 읽기 전용이거나 되돌릴 수 있는 작업은 자동으로 진행하며, 다섯 개의 사람 승인 지점에서 멈춥니다.
| # | 단계 | 스킬 | 출력 → 다음 단계 |
|---|---|---|---|
| 1 | 문헌 탐색 | research-hub, paper-summarize | .bib + 논문별 핵심 발견 노트 → 2단계 |
| 2 | 공백 찾기 | gap-to-topic, literature-triage-matrix, notebooklm-brief-verifier, zotero-library-curator | topic_dossier.gaps.yml(verdict, verdict_reason 포함) → 3a단계 |
| 3a | 연구 질문 짜기 | research-design-helper | design_brief.md(frontmatter source: gaps.yml#G2, gap_verdict) → 3b단계 + 4단계 |
| 3b | 프로젝트 계획 | research-context-compressor, research-project-orienter | project_manifest.yml(provenance.from_gap) → 4–8단계 |
| 4 | 모델 만들기 | 쿡북 — 파일 5개 이상 뼈대는 codex-delegate, 4개 이하거나 판단이 필요하면 Claude 직접 | 내 프로젝트 저장소의 코드(쿡북 참고) → 5단계 |
| 5 | 실행 및 검증 | research-context-compressor, research-project-orienter | 앞으로의 AI 세션이 다시 훑지 않도록 하는 .research/ 실행 매니페스트 → 6단계 |
| 6 | 시각화 및 해석 | codex-delegate, antigravity-delegate, 주 모델 | 그림 + 분석 스크립트 → 7단계 |
| 7 | 원고 초안 쓰기 | paper-memory-builder, academic-writing-skills | .paper/claims.yml(status 열거값 + 누수 방지) → 8단계 |
| 8 | 제출 + 답변 | academic-writing-skills, research-context-compressor | reviewer-response.md, 버전 태그가 붙은 매니페스트 → 끝 |
스킬 간 인수인계(2 → 3a → 3b → 8단계, 7 → 8단계)는 자유 텍스트가 아니라 YAML 스키마로 문서화되어 있습니다. 하류 스킬은 잘못된 인수인계를 처리하지 않을 수 있고, 스키마 위반이 그대로 전파될 때는 실제로 거부합니다(예: gap_reason이 없는 status: gap 주장은 7단계에서 거부됩니다).
모든 단계에 걸친 것: research-workflow-orchestrator, codex-delegate, antigravity-delegate, research-hub-multi-ai. 이들은 파이프라인 위가 아니라 옆에 놓입니다. 오케스트레이터는 생애주기 상태와 승인 지점을 보존하고, 다중 에이전트 라우팅은 범위가 정해진 기계적 실행에 Codex와 Antigravity를 씁니다.
전체 서술 + 단계별 도구 표: docs/pipeline.md.
4. 사용하기
목표로 고르기
위의 전체 파이프라인을 읽고 싶지 않다면, 당장의 목표로 바로 시작하세요.
| 당장의 목표 | 쓰게 될 스킬 |
|---|---|
| 문헌 찾기와 비교 | research-hub + literature-triage-matrix |
| 논문 쓰기 또는 고치기 | paper-memory-builder + academic-writing-skills |
| 연구 프로젝트 관리 | research-design-helper + research-context-compressor + zotero-library-curator |
문헌 탐색은 Codex나 Claude Code에서 실제로 쓸 수 있는 검색 및 자료 읽기 기능으로 시작하세요. Zotero, Obsidian, NotebookLM은 선택 사항이며 반드시 거쳐야 하는 설정이 아닙니다. 기존 1단계 근거 인수인계를 따르세요.
💡 다른 사람이 연구에 AI를 도입하도록 돕나요(사서 / 연구조수 / 지도교수)? 설치는 필요 없습니다. 이 README와 docs/install.md를 공유하세요.
또는 원하는 것을 그냥 설명하세요
원하는 것을 일상어로 설명하면 Claude Code가 표현에 맞는 스킬을 고릅니다. 스킬 이름을 외울 필요는 없습니다.
| 이렇게 말하면… | 켜지는 스킬 |
|---|---|
| "Compare these 5 papers by method, data, limitations" | literature-triage-matrix |
| "Is this gap worth a thesis? Walk me through the three gates" | gap-to-topic |
| "Walk me through my research design before I start coding" | research-design-helper |
| "Check this paragraph's terminology, repeated wording, flow, and overclaim" | academic-writing-skills |
| "Review this paper and load the relevant notation, display, SEM, LLM, water, or flood checks" | paper-review |
전체 트리거 지도(17행): docs/skill-directory.md. 자동 트리거가 잘못된 스킬을 고르면 이름을 직접 말하세요. "Use literature-triage-matrix to compare these 5 papers."
이미 Zotero / Obsidian / NotebookLM을 쓰고 계신가요?
💡 워크플로에 Zotero / Obsidian / NotebookLM 중 하나라도 있나요?
research-hub가 가진 것들을 하나의 라이브러리 관리 루프로 통합합니다. 새 문헌 검색(arXiv, Semantic Scholar) → Zotero 메타데이터 + 수집 → 논문별 노트를 Obsidian에 동기화 → NotebookLM 브리프를 소스 묶음과 대조해 검증합니다. 세 도구 모두 선택 사항입니다 —research-hub는 가진 것의 부분집합(아무것도 없어도, 샘플 대시보드 모드로)에 맞춥니다. Python CLI를 받침하며pip install research-hub-pipeline으로 설치합니다.이런 도구를 위한 독립 MCP 서버(예:
paper-search-mcp, Zotero MCP, NotebookLM MCP)를 이미 쓰고 있나요? 함께 쓸 수 있습니다. 스킬은 워크플로를 조율하고, MCP는 원시 도구 접근을 줍니다. CLI 자체도 MCP 인터페이스(research-hub serve)를 제공합니다. 전체 설정과 도구별 모드: research-hub 프로젝트 README.
스킬 17개 전부
research-hub에서 온 스킬(12개) — 설치 한 번으로 모두 받습니다
research-hub— Zotero / Obsidian / NotebookLM에 걸쳐 논문을 검색, 수집, 정리합니다. (1, 2단계)literature-triage-matrix— 방법, 데이터, 주장, 한계를 비교하는 매트릭스. (2단계)notebooklm-brief-verifier— NotebookLM 브리프를 소스 묶음과 대조해 검증합니다. (2단계)zotero-library-curator— Zotero를 점검하고 정리를 제안합니다(zotero-skills가 없으면 미리보기 전용). (2단계)gap-to-topic— 후보 학위논문/제안 주제에 대한 3단 게이트 진행/중단 결정 자료(열려 있는가? 기여인가? 실현 가능한가?).research-design-helper의 3a단계 인수인계용.gaps.yml을 내보냅니다. (2단계)research-design-helper— RQ → 메커니즘 → 식별 가능성 → 검증 → 위험을 소크라테스식 대화로 짚습니다..gaps.yml을 읽어 1·5번 항목을 미리 채우고, 4단계 쿡북이 만들어 낸design_brief.md를 재사용합니다. (3a, 4단계)research-context-compressor— 앞으로의 AI 세션이 다시 훑지 않도록.research/매니페스트를 만듭니다. (3b, 5, 8단계)research-project-orienter— 그 매니페스트로 빠른 파악 메모를 만듭니다. (3b, 5단계)research-hub-multi-ai— 주 모델, Codex, Antigravity 사이의 성격 기반 라우팅. (전 단계 공통)research-workflow-orchestrator— 방향 잡기 → 범위 정하기 → 탐색 → 종합 → 설계 → 실행 → 작성 → 릴리스를 이어 가는 컨트롤러. 읽기 전용/되돌릴 수 있는 작업은 자동으로 진행하고 카탈로그의 사람 승인 지점에서 멈춥니다. (모든 단계)paper-memory-builder—.paper/claims.yml+.paper/figures.yml(status 열거값, 누수 방지 규칙, 파일 센티널). (7단계)paper-summarize—research-hub auto뒤에 Obsidian과 Zotero 하위 노트 모두에 논문별 핵심 발견 / 방법론 / 관련성을 채웁니다. (1단계)
독립 저장소(플러그인 4개) — 플러그인마다 설치 한 번
academic-writing-skills— 확장 개요, 범위를 정한 초안 전 계획과 수정 후 점검, 장 마무리, 공유 용어 기록, 4패스 원고 검토, 산출물 간 수정, 릴리스 준비 상태. (7, 8단계)paper-review— 일반 과학 논문 리뷰. 수식/표시 출처, 심리측정/SEM, AI/LLM, 물/CNHS, 홍수/수력학, 라운드, 명시적 심사위원 모듈을 단계적으로 고릅니다. (7, 8단계)zotero-skills— Zotero 전체 CRUD, 일괄 메타데이터, 라이브러리 유지보수. (1, 2, 7단계)codex-delegate— 코드 비중이 크거나 기계적인 작업을 위한 Claude → Codex CLI 인계. (전 단계 공통, 4·6단계도)antigravity-delegate— 정직성이 핵심이 아닌 범위가 정해진 기계적 작업을 위한 Claude → Antigravity CLI 인계. (전 단계 공통, 4·6단계도)
소요 시간 + 비용 기대치
세션 안 사용에서 잡은 대략적인 범위입니다. 입력 크기에 맞게 조정하세요.
| 작업 | 보통 걸리는 시간 | 대화 턴 수 | 비고 |
|---|---|---|---|
논문 5편 비교(literature-triage-matrix) | 1–3분 | 1–2 | 논문 수에 비례합니다. 20편이면 약 5분 |
3단 게이트 공백 판정(gap-to-topic) | 5–15분 | 3–6 | 후보 수와 문헌 회상 깊이에 따라 커집니다 |
문단 1개의 용어 · 반복 · 흐름 점검(academic-writing-skills) | 1분 미만 | 1 | 원고 크기와 무관합니다 |
심사위원 답변(코멘트 6개)(academic-writing-skills) | 3–8분 | 3–5 | 코멘트의 깊이와 필요한 수정에 따라 커집니다 |
Zotero 라이브러리 800개 항목 점검(zotero-library-curator) | 2–4분 | 1 | 읽기 전용. 라이브러리 크기보다 태그 다양성이 더 중요합니다 |
클러스터당 논문 5편 요약(paper-summarize) | 4–10분 | 1 | 논문당 LLM 호출 한 번. 실패하면 논문 단위로 롤백합니다 |
이 범위는 관리자가 관찰한 범위일 뿐 벤치마크 수치가 아닙니다. 실제 시간은 LLM 공급자, 네트워크, 라이브러리 상태, 프롬프트 표현에 따라 달라집니다.
⚠ CRUD 작업 전에 Zotero를 백업하세요
zotero-library-curator는 읽기 전용이며 미리보기 보고서를 내놓습니다. zotero-skills는 쓸 수 있습니다(중복 병합, 항목 삭제, 컴렉션 다시 연결). AI가 라이브러리를 수정하게 하기 전에 반드시 Zotero 백업을 내보내세요: Zotero → File → "Export Library…" → Zotero RDF. 스킬이 대신 해 주지 않습니다.
5. 각 스킬이 내놓는 결과 보기
각 파이프라인 단계의 결과물에는 실제 작업 예시 파일이 있습니다. 설명이 아니라 스킬이 실제로 내놓는 결과물을 눌러서 확인하세요.
| 단계 | 스킬이 만드는 것 | 예시 파일 |
|---|---|---|
| 1–2 | 문헌 검토 결과물(TL;DR + 논문별 종합 + 태그가 붙은 공백 분석) | example-literature-review-deliverable.md · .docx |
| 2 | 3단 게이트 결정(열림 / 기여 / 실현 가능성)이 들어 있는 주제 자료 + 기계가 읽을 수 있는 공백 목록 | example-topic-dossier.md + .gaps.yml · .docx |
| 3a | 자료에 대한 출처가 달린 연구 설계서. RQ → 메커니즘 → 식별 가능성 → 검증 → 위험을 소크라테스식으로 따라감 | example-design-brief.md |
| 3b | provenance.from_gap을 담아 앞으로의 AI 세션이 다시 훑지 않게 하는 프로젝트 매니페스트 | example-project-manifest.yml |
| 4 | 쿡북 — 설계서에서 뼈대 코드까지 가는 두 가지 길(파일 4개 이하는 Claude 직접, 5개 이상은 codex-delegate) | example-design-to-build.md |
| 7 | status: gap 누수 방지 규칙이 있는 논문 주장 + 원고에 삽입된 센티널이 있는 그림 목록 | example-paper-memory-claims.yml + example-paper-memory-figures.yml |
모든 단계에 걸친 스킬과 오케스트레이션 스킬(research-hub 수집, research-project-orienter, research-hub-multi-ai, notebooklm-brief-verifier)은 한 단계의 결과물에 대응되지 않습니다. 실제 도그푸딩 실행의 test-corpus/에서 처음부터 끝까지 쓰였습니다. 파악 메모, 다중 AI 라우팅 결정, NotebookLM 브리프 검증이 그 예입니다.
또는 스킬별 입출력 표가 있는 서술형 투어를 docs/examples.md에서 처음부터 끝까지 읽어 보세요.
6. FAQ
중국어 문헌도 되나요?
네 — 스킬은 언어에 구애받지 않습니다. 중국어로 돌리면 결과도 중국어로 나옵니다. NotebookLM, Claude, Gemini 모두 번체 / 간체 중국어를 잘 다룹니다.
지도교수에게 보낼 .docx로는 어떻게 내보내나요?
2단계 자료와 1–2단계 문헌 검토 결과물에는 .docx 생성기가 들어 있습니다 — 위 5절에 바로 가기 링크가 있습니다. 다른 단계(design_brief.md, project_manifest.yml, claims.yml)는 Markdown / YAML을 내보내므로, 필요하면 pandoc을 거치거나 Word의 "Open Markdown"을 쓰세요.
7. 호환성
이식 가능한 계층은 SKILL.md 지시 파일과 함께 들어 있는 references/, scripts/, 워크플로 계약입니다. Claude Code 마켓플레이스 지원은 호스트 전용 패키징 계층 하나일 뿐, 스킬을 쓰는 유일한 방법이 아닙니다.
| 계층 | 이식 가능한 것 | 상태 |
|---|---|---|
범용 SKILL.md 계층 | 스킬 지시, 트리거 설명, 참고 자료, 스크립트, 프로젝트 인수인계 계약 | 카탈로그에 스킬 17개. 기록된 소스 레이아웃/매니페스트 점검만으로는 실제 호스트 동작을 보증할 수 없음 |
| 호스트별 동작 | 자동 트리거, 플러그인 마켓플레이스 설치, claude plugin list, 스킬 탐색, rules 폴더 규칙 | 에이전트 호스트에 따라 다릅니다. 그 호스트 고유의 목록/탐색 확인을 쓰세요 |
| 현재 이식성 점검 | SKILL.md를 읽는 일반 호스트 | 2026-05-10 점검에서 14개 중 11개는 수정 없이 이식 가능, 3개는 경로 표기를 손봐야 했고 그 수정은 이후 반영됨 |
| 검증된 호스트 설치 | NousResearch/hermes-agent 0.13.0 | literature-triage-matrix를 처음부터 끝까지 설치, 보안 스캔 SAFE, enabled로 등록. Hermes 추론 루프는 시험하지 않았음 |
| OpenClaw | 사용자의 OpenClaw 설치가 지원할 때 ~/.openclaw/skills/<이름>/SKILL.md 같은 SKILL.md 폴더 모양 | 구조적으로는 호환되는 대상이지만, 이 저장소가 아직 릴리스 수준으로 검증하지 않았음 |
| 다른 에이전트 | Codex CLI, Gemini CLI, Cursor, Windsurf, 일반 API 클라이언트, 그 밖의 SKILL.md를 읽는 호스트 | 같은 SKILL.md를 맥락으로 넣거나 호스트의 skills/rules 폴더에 넣음. 모든 호스트를 하나씩 테스트하지는 않았음 |
11/14 이식성 수치는 카탈로그에 스킬이 14개였던 2026-05-10에 돌린 점검을 반영한 것입니다. 이후 추가된 스킬(gap-to-topic, paper-review, research-workflow-orchestrator, antigravity-delegate)은 별도의 카탈로그 기록이 있고 그 이식성 점검에 포함되지 않았습니다.
보정된 점검과 실험 기록: .research/hermes-compatibility-audit.md.
문서화된 Codex CLI / Gemini CLI / Cursor / Windsurf / Hermes 및 일반 API 예시는 docs/install.md → Claude Code 밖에서 이 스킬 쓰기를 보세요. OpenClaw는 이 저장소가 릴리스 수준의 OpenClaw 검증을 추가할 때까지 위의 SKILL.md 폴더 모양을 쓰세요.
8. 한계
- 대학원생 연구자 한 명이 모으고 시험했습니다. 대규모 코퍼스로 검증되지 않았습니다.
- 수자원과 에이전트 기반 모델링 쪽으로 치우쳐 있습니다. 사회과학, ML, 임상 글쓰기에는 검증되지 않았습니다.
- 실제 입력에서의 동작 정확성은 이 카탈로그가 아니라 원본 저장소의 책임입니다.
- 보고 전용 월간 상태/드리프트 점검은 상위 저장소, 매니페스트, 스킬 URL, 검증 시점 기록을 살펴봅니다. HTTP 응답 성공이나 소스 레이아웃 점검만으로는 실제 호스트 동작이 입증되거나 사람의 검증 날짜가 갱신되지 않으며, 해결되지 않은 발견은 사람이 검토해야 합니다.
- CI는
claude plugin install왜복을 보장하지 않습니다. 마켓플레이스 레지스트리는 구조적으로 점검하고, 실제 설치 + 트리거 경로는 릴리스 사이에 관리자가 확인합니다(무엇이 다루어지고 무엇이 아닌지는 docs/verification.md 참고). - 현재 research-workspace 소스는 더 이상
zotero-skills를 내장하지 않습니다. 독립 플러그인이 정식입니다. 2026-05-20 검증의 이름 충돌은 과거의 일입니다. 예전 호스트 캐시는 현재 소스와 다를 수 있으므로, 소스 수정이 로컬 업데이트로 이어졌다고 보기 전에 설치된 플러그인 상태를 확인하세요.
전체 설계 계약 — 기계가 점검하는 것과 점검하지 않는 것 포함 — 은 docs/design-philosophy.md에 있습니다.
라이선스
MIT. 각 스킬은 자기 정식 저장소에서 관리됩니다 — 이 카탈로그는 모노레포가 아니라 색인입니다. 이슈나 PR로 기여를 환영합니다. 새 스킬 제안은 research-hub(워크플로 통합) 또는 독립 저장소(깊이 있는 단일 목적 CRUD)로 보내세요.
저장소
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0


