diff --git a/LAUNCH.md b/LAUNCH.md
new file mode 100644
index 0000000..bb10016
--- /dev/null
+++ b/LAUNCH.md
@@ -0,0 +1,110 @@
+# Launch Kit — paper-writer-skill
+
+Use this file to announce the GitHub Pages landing and Week 1 packaging without rewriting copy from scratch.
+
+## Launch Goal
+
+Put the skill in front of clinicians, clinician-scientists, and agent users who write medical/scientific manuscripts — and who care that IDEA/DATA stay human.
+
+Primary outcomes: GitHub stars, installs via `npx skills add`, forks, saves, thoughtful replies, inbound case-study requests.
+
+**Do not invent metrics** (user counts, acceptance rates, journal names of "wins").
+
+## Links to include everywhere
+
+- Live landing: https://kgraph57.github.io/paper-writer-skill/
+- Case study (2-minute read): https://github.com/kgraph57/paper-writer-skill/blob/main/examples/case-studies/discovery-to-draft.md
+- Repo: https://github.com/kgraph57/paper-writer-skill
+- Install: `npx skills add kgraph57/paper-writer-skill`
+
+## Release Copy (Week 1 / v3.2 packaging)
+
+Lead with: research engine ≠ manuscript factory → Discovery gates → humanizer → adversarial review → install + star.
+
+### X / Twitter (JP) — primary
+
+```text
+原稿工場じゃなく、研究エンジン。
+
+paper-writer-skill(Claude Code / エージェント用):
+- Phase −1 Discoveryで質問を鍛え、💡IDEA と 📊DATA は人間がロック
+- ステージゲート付きIMRAD(FAILなら自動修正ループ)
+- 日英ヒューマナイズ(学術AIパターン除去)
+- 敵対的レビューが弱い主張をKILLできる
+
+紹介サイト: https://kgraph57.github.io/paper-writer-skill/
+ケース(2分): https://github.com/kgraph57/paper-writer-skill/blob/main/examples/case-studies/discovery-to-draft.md
+Install: npx skills add kgraph57/paper-writer-skill
+★ Starもらえると助かります
+```
+
+### X / Twitter (EN)
+
+```text
+Not a manuscript factory. A research engine.
+
+paper-writer-skill for Claude Code / agents:
+- Phase −1 Discovery forges questions; humans lock 💡 IDEA and 📊 DATA
+- Stage-gated IMRAD with auto-fix loops on FAIL
+- EN+JP academic humanizer (AI-tell patterns)
+- Adversarial review that can KILL a weak claim before submission
+
+Landing: https://kgraph57.github.io/paper-writer-skill/
+Case study (2 min): https://github.com/kgraph57/paper-writer-skill/blob/main/examples/case-studies/discovery-to-draft.md
+Install: npx skills add kgraph57/paper-writer-skill
+★ Star if this is the manuscript workflow you wanted
+```
+
+### Show HN (Hacker News)
+
+```text
+Title: Show HN: Agent skill for medical manuscripts – discovery gates, humanizer, adversarial review
+
+I packaged my Claude Code / agent skill for medical and scientific
+writing with a public landing page and a 2-minute case study.
+
+It is intentionally not a "paste notes → camera-ready PDF" factory.
+Phase −1 Discovery forges and ranks research questions, checks novelty
+against live literature, and stops until a human locks the 💡 IDEA and
+confirms 📊 DATA (real, never model-invented). Drafting then runs through
+stage-gates with auto-fix loops, an EN+JP academic humanizer, citation
+checks, and an adversarial review that can KILL a weak central claim
+before any journal sees it.
+
+Six paper types (original, case report, review, SR, letter, protocol),
+20+ reporting guidelines, team mode with parallel agents, and tested
+Python utilities (table1, SR helpers). Network is used for literature
+APIs — not telemetry. Raw clinical data stays local / gitignored.
+
+Landing: https://kgraph57.github.io/paper-writer-skill/
+Case study: https://github.com/kgraph57/paper-writer-skill/blob/main/examples/case-studies/discovery-to-draft.md
+Install: npx skills add kgraph57/paper-writer-skill
+Repo: https://github.com/kgraph57/paper-writer-skill
+```
+
+### LinkedIn (short, optional)
+
+```text
+Shipping a public intro site for paper-writer-skill — an agent skill for medical/scientific manuscripts.
+
+Thesis: research engine ≠ manuscript factory. Humans stay sovereign on IDEA and DATA; the agent runs discovery, stage-gated IMRAD, EN+JP humanizing, and adversarial review.
+
+Landing: https://kgraph57.github.io/paper-writer-skill/
+Install: npx skills add kgraph57/paper-writer-skill
+```
+
+### Reddit (optional — tone check before posting)
+
+Good fits when the community allows tool shares: r/ClaudeAI, r/LocalLLaMA (agent workflows), academic writing communities that accept OSS tool posts. Lead with the case study + sovereignty gates; avoid hype and medical advice. Do not spam.
+
+```text
+I open-sourced an agent skill (SKILL.md) for medical manuscript workflows: discovery gates before drafting, stage-gates, EN+JP humanizer, adversarial review. Humans lock IDEA/DATA. Landing + 2-min case study in the links. Not affiliated with any journal. Feedback welcome on the discovery → kill-path design.
+```
+
+## Checklist before posting
+
+- [ ] GitHub Pages live at `/docs` on `main` (see `POST_MERGE.md`)
+- [ ] Repo `homepage` set to the Pages URL
+- [ ] Case study link returns 200
+- [ ] LICENSE is MIT (not "Private repository" in README)
+- [ ] Topics include `claude-skills`, `claude-code-skill`, `agent-skills`
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..efd9648
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KEN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.ja.md b/README.ja.md
index 28df097..562eef1 100644
--- a/README.ja.md
+++ b/README.ja.md
@@ -1,378 +1,101 @@
-# Paper Writer Skill(日本語ドキュメント)
+
+
# Paper Writer Skill
+**Not a manuscript factory. A research engine.**
+
+A Claude Code / agent skill for medical and scientific manuscripts: Discovery gates, stage-gated IMRAD drafting, EN+JP humanizing, adversarial review, and submission/revision loops. Humans stay sovereign on the **💡 IDEA** and the **📊 DATA**.
+
[](https://github.com/kgraph57/paper-writer-skill/actions/workflows/tests.yml)
+[](LICENSE)
+[](SKILL.md)
+[](CHANGELOG.md)
+
+English | [日本語](README.ja.md)
+
+**Live intro:** https://kgraph57.github.io/paper-writer-skill/
+
+
+
+## Why This Gets Starred
+
+- **Discovery before drafting.** Phase −1 forges and ranks research questions, checks novelty against live literature, and designs/powers the study — then stops until a human locks the 💡 IDEA and confirms 📊 DATA (real, IRB-aware, never model-invented).
+- **Stage-gates that auto-fix.** Eight quality gates. FAIL → structured feedback → fixer agent → re-check (up to 3 loops). No silent proceed to the next phase.
+- **Adversarial review can KILL.** Before submission, the skill red-teams its own central claim. Fatal problems return to Discovery instead of polishing a bad paper.
+- **EN + JP humanizer.** Phase 4 removes academic AI-tell patterns (18 English + 13 Japanese) with before/after examples and section priorities — see `references/humanizer-academic.md`.
+- **Six paper types, 20+ guidelines.** Original, Case Report, Review, Systematic Review, Letter/Short, Study Protocol — CARE / CONSORT / STROBE / PRISMA / SPIRIT and more wired into templates.
+- **Team mode.** Seven parallel specialist agents for literature, drafting, humanize, and review (v3.0+).
+- **Tested utilities.** `table1.py`, SR helpers, compile/word-count scripts — CI runs `unittest` + shell syntax checks.
+
+## 60-Second Start
-A Claude Code skill for medical/scientific paper writing. Covers the entire manuscript lifecycle from literature search to submission, peer review response, and rejection handling.
+```bash
+# 1. Install as an agent skill (Claude Code, Cursor, Codex, and other skills hosts)
+npx skills add kgraph57/paper-writer-skill
+```
-> **日本語版はこちら → [README.ja.md](README.ja.md)**
+Or clone into Claude Code’s skills directory:
-## Overview
+```bash
+git clone https://github.com/kgraph57/paper-writer-skill.git ~/.claude/skills/paper-writer
+```
-Not just a *manuscript factory* (write → format → submit) but a *research engine*:
-a discovery loop that generates and ranks research questions, checks their novelty
-against the live literature, designs and powers the study, locks a pre-registered
-plan, and — after the manuscript is drafted — red-teams its own central claim before
-any journal sees it. Two things stay human and protected at every gate: the **💡 IDEA**
-(what is worth asking, what it means, what is ethical) and the **📊 DATA** (real,
-IRB-approved, never machine-originated). See
-[`references/ai-for-science-model.md`](references/ai-for-science-model.md).
+Then ask in plain language:
+
+```text
+Use the paper-writer skill to start a CARE case report from these de-identified notes…
+```
+
+```text
+論文を書く。症例報告。CARE。データは匿名化済み。
+```
-A pipeline that generates and manages IMRAD-format project directories with
-structured Markdown files, a literature matrix, and quality checklists.
+Triggers: `write paper` / `start manuscript` / `research paper` / `論文を書く` / `論文執筆` / `原稿作成` — or `/paper-writer` in Claude Code.
+
+## The Pipeline
```mermaid
graph LR
@@ -32,107 +66,17 @@ graph LR
P6 --> P65["6.5 Adversarial Review"]
P65 --> P7[7. Pre-Submission]
P65 -.->|KILL| P0
- P7 --> P8["8. Revision ①"]
+ P7 --> P8["8. Revision"]
P8 --> P9["9. Post-Acceptance"]
P7 -.-> P10["10. Rejection → Resubmit"]
P10 -.-> P1
```
-## Architecture: Autonomous Stage-Gate System (v3.1)
+Optional Python packages for analysis/PDF utilities: `python -m pip install -r requirements.txt`. Literature work uses WebSearch/WebFetch and public literature APIs — **not** a zero-network skill (by design).
-Every phase is guarded by a quality gate. If the gate returns **FAIL**, the system automatically generates structured feedback, dispatches a fixer agent in `revision_mode`, and re-checks — up to 3 iterations before escalating to the user. No phase proceeds until its gate returns **PASS**.
+## Case Study (2-minute read)
-```mermaid
-flowchart TD
- subgraph "Per-Phase Loop (max 3 iterations)"
- A["Phase N Complete"] --> B{"Quality Gate"}
- B -->|PASS| C["→ Phase N+1"]
- B -->|FAIL iter < 3| D["Generate feedback.md"]
- D --> E["Fixer Agent\n(revision_mode)"]
- E --> B
- B -->|FAIL iter ≥ 3| F["⚠ Escalate to User"]
- end
-
- style B fill:#f9a825,stroke:#f57f17,color:#000
- style C fill:#66bb6a,stroke:#388e3c,color:#fff
- style F fill:#ef5350,stroke:#c62828,color:#fff
-```
-
-### 8 Quality Gates
-
-```mermaid
-flowchart LR
- subgraph "Phase 1"
- G1["📚 Literature\n≥10 papers\nAll DOIs valid"]
- end
- subgraph "Phase 2"
- G2["📋 Outline\nAll IMRAD sections\n≥2 citations mapped"]
- end
- subgraph "Phase 2.5"
- G25["📊 Tables/Figures\nAll designs complete\nJournal limits OK"]
- end
- subgraph "Phase 3"
- G3["✍️ Section Draft\nScore ≥80%\nMust Fix = 0"]
- end
- subgraph "Phase 4"
- G4["🔍 Humanize\nHigh-priority\nAI patterns = 0"]
- end
- subgraph "Phase 5"
- G5["📖 References\nFabrication = 0\nOrphan cites = 0"]
- end
- subgraph "Phase 6"
- G6["🔗 Cross-Section\nPASS or\nCONDITIONAL_PASS"]
- end
- subgraph "Phase 7"
- G7["📦 Submission\nAll docs ready\nWord count OK"]
- end
-
- G1 --> G2 --> G25 --> G3 --> G4 --> G5 --> G6 --> G7
-```
-
-### Team Mode: 7 Parallel Agents (v3.0)
-
-Phases are parallelized with specialized agents running concurrently:
-
-```mermaid
-flowchart TB
- subgraph P1["Phase 1 — Literature Search (3 parallel)"]
- L1[PubMed Searcher]
- L2[Google Scholar Searcher]
- L3[Domain DB Searcher]
- end
-
- subgraph P3["Phase 3 — Drafting (grouped parallel)"]
- direction LR
- D1[Methods] --> D3[Intro]
- D2[Results] --> D4[Conclusion]
- end
-
- subgraph P4["Phase 4 — Humanize (up to 6 parallel)"]
- H1[Humanizer × N sections]
- end
-
- subgraph P6["Phase 6 — Quality Review"]
- R1[Section Reviewer ×N]
- R2[Quality Gate — opus]
- end
-
- L1 & L2 & L3 --> MERGE["Merge Matrix"]
- MERGE --> D1 & D2
- D3 & D4 --> H1
- H1 --> R1
- R1 --> R2
-```
-
-| Agent | Role | Model |
-|-------|------|-------|
-| `paper-lit-searcher` | Database-specific literature search | sonnet |
-| `paper-table-figure-planner` | Table and figure design | sonnet |
-| `paper-section-drafter` | Section drafting (parameterized) | sonnet |
-| `paper-humanizer` | AI writing pattern removal | haiku |
-| `paper-ref-builder` | Citation collection and verification | sonnet |
-| `paper-section-reviewer` | Per-section quality check | sonnet |
-| `paper-quality-gate` | Cross-section consistency + final verdict | opus |
+**[Discovery → draft → humanize → adversarial catch](examples/case-studies/discovery-to-draft.md)** — an illustrative CARE spark (PHI-free) showing why gates beat “just write the abstract.”
## Supported Paper Types
@@ -145,247 +89,56 @@ flowchart TB
| **Letter / Short Communication** | Condensed IMRAD | Same as original |
| **Study Protocol** | SPIRIT-compliant | SPIRIT 2025 |
-## Usage
-
-### Invoke from Claude Code
-
-```
-/paper-writer
-```
-
-Or use natural language triggers:
-- `write paper` / `start manuscript` / `research paper`
-- `論文を書く` / `論文執筆` / `原稿作成`
-
-### Project Setup
-
-The skill prompts you for:
-
-1. **Working title**
-2. **Paper type** (one of the 6 types above)
-3. **Target journal** (optional, recommended)
-4. **Language** (English / Japanese / Both)
-5. **Research question** (one sentence)
-6. **Available data** (existing tables/figures)
-
-When a target journal is specified, the skill automatically looks up word limits, citation style, abstract format, and other requirements.
-
-## Generated Project Structure (v3.2)
-
-Each paper project generates a comprehensive directory for managing the entire research lifecycle:
+## Architecture (deep dive)
-```
-{project-dir}/
-├── README.md # Project dashboard (status, timeline, links)
-├── 00_literature/ # Literature search & matrix
-├── 01_outline.md # Paper skeleton
-├── sections/ # Manuscript sections (writing order)
-│ ├── 02_methods.md ... 08_title.md
-├── tables/ # Tables (numbered)
-├── figures/ # Figures + captions
-├── supplements/ # Supplementary materials
-│ ├── supplementary-tables/
-│ ├── supplementary-figures/
-│ └── appendices/
-├── data/ # Research data (raw → processed → analysis)
-│ ├── raw/ # Original data (READ-ONLY, gitignored)
-│ ├── processed/ # Cleaned, de-identified
-│ ├── analysis/ # Statistical output
-│ └── data-dictionary.md
-├── ethics/ # IRB, consent, protocol, registration
-├── submissions/ # Submission history (v1_bmj/, v2_lancet/, ...)
-│ └── v1_{journal}/ # Compiled manuscript + cover letter + declarations
-├── revisions/ # Revision rounds (r1/, r2/, ...)
-│ └── r1/ # Reviewer comments + response + diff
-├── coauthor-review/ # Co-author feedback tracking
-├── correspondence/ # Editor & reviewer communication log
-├── references/ # Formatted reference list
-├── checklists/ # Quality gates, reporting guideline tracking
-└── log/ # Decisions, meetings, timeline
-```
-
-## File Structure
+### Autonomous Stage-Gate System (v3.1)
-```
-paper-writer/
-├── SKILL.md # Main workflow definition
-├── CHANGELOG.md # Version history
-├── README.md # This file
-├── README.ja.md # Japanese documentation
-├── requirements.txt # Python dependencies for utility scripts
-│
-├── templates/ # 37 files — Section templates
-│ ├── project-init.md # Project initialization (Original Article)
-│ ├── project-init-case.md # Project initialization (Case Report)
-│ ├── research-question.md # Question forge and FINER scoring
-│ ├── study-design.md # Study design, variables, power, feasibility
-│ ├── preregistration.md # Pre-registration lock template
-│ ├── human-loop-ledger.md # Human/AI accountability ledger
-│ ├── literature-matrix.md # Literature comparison matrix
-│ ├── methods.md # Methods writing guide
-│ ├── results.md # Results writing guide
-│ ├── introduction.md # Introduction writing guide
-│ ├── discussion.md # Discussion writing guide
-│ ├── conclusion.md # Conclusion writing guide
-│ ├── abstract.md # Abstract writing guide (Original Article)
-│ ├── cover-letter.md # Cover letter template
-│ ├── submission-ready.md # Pre-submission checklist
-│ ├── case-report.md # Case presentation (CARE-compliant)
-│ ├── case-introduction.md # Case report introduction
-│ ├── case-abstract.md # Case report abstract (CARE format)
-│ ├── review-article.md # Review article structure guide
-│ ├── sr-outline.md # Systematic review outline
-│ ├── sr-data-extraction.md # SR data extraction template
-│ ├── sr-prisma-flow.md # PRISMA flow diagram
-│ ├── sr-grade.md # GRADE evidence assessment
-│ ├── sr-rob.md # Risk of bias assessment
-│ ├── sr-prospero.md # PROSPERO registration template
-│ ├── sr-screening-pipeline.md # Dual-screening execution pipeline
-│ ├── response-to-reviewers.md # Response to reviewers template
-│ ├── revision-cover-letter.md # Revision cover letter
-│ ├── declarations.md # Declarations (ethics, COI, funding, AI disclosure)
-│ ├── graphical-abstract.md # Graphical abstract guide
-│ ├── title-page.md # Title page template
-│ ├── highlights.md # Key points / highlights (JAMA, BMJ, etc.)
-│ ├── limitations-guide.md # Limitations section guide
-│ ├── acknowledgments.md # Acknowledgments template
-│ ├── proof-correction.md # Post-acceptance proof correction guide
-│ ├── data-management.md # Data management (raw/processed/analysis)
-│ └── analysis-workflow.md # Data analysis workflow guide
-│
-├── references/ # 30 files — Reference materials
-│ ├── ai-for-science-model.md # Research-engine operating model
-│ ├── novelty-check.md # Live-literature novelty check
-│ ├── adversarial-review.md # Design/manuscript red-team review
-│ ├── imrad-guide.md # IMRAD structure and writing principles
-│ ├── section-checklist.md # Per-section quality checklist
-│ ├── citation-guide.md # Citation formatting and management
-│ ├── citation-verification.md # Citation verification guide
-│ ├── reporting-guidelines.md # Reporting guidelines summary
-│ ├── reporting-guidelines-full.md # 20+ reporting guidelines with checklists
-│ ├── humanizer-academic.md # AI writing detection (EN 18 + JP 13 patterns)
-│ ├── statistical-reporting.md # Statistical reporting guide
-│ ├── statistical-reporting-full.md # Extended SAMPL guide
-│ ├── journal-selection.md # Journal selection strategy
-│ ├── pubmed-query-builder.md # PubMed search query builder
-│ ├── multilingual-guide.md # Multilingual support guide
-│ ├── coauthor-review.md # Co-author review process
-│ ├── ai-disclosure.md # ICMJE 2023 AI disclosure guide
-│ ├── tables-figures-guide.md # Tables and figures creation guide
-│ ├── keywords-guide.md # Keywords and MeSH selection strategy
-│ ├── supplementary-materials.md # Supplementary materials strategy
-│ ├── hook-compatibility.md # Claude Code hook compatibility
-│ ├── submission-portals.md # Submission portal guide
-│ ├── open-access-guide.md # OA models, APCs, CC licenses
-│ ├── clinical-trial-registration.md # Clinical trial registration guide
-│ ├── abstract-formats.md # Journal-specific abstract formats
-│ ├── word-count-limits.md # Word count limits by journal
-│ ├── coi-detailed.md # COI categories, CRediT taxonomy, ORCID
-│ ├── desk-rejection-prevention.md # Desk rejection prevention
-│ ├── journal-reformatting.md # Journal reformatting and cascading strategy
-│ └── master-reference-list.md # Master URL list (100+ links, 13 categories)
-│
-├── scripts/ # 8 files — Utilities & Analysis
-│ ├── compile-manuscript.sh # Compile sections into single manuscript
-│ ├── word-count.sh # Word count utility
-│ ├── forest-plot.py # Forest plot generator
-│ ├── sr-dedup.py # SR record parsing and de-duplication
-│ ├── sr-pdf-link.py # Link full-text PDFs to records by DOI
-│ ├── sr-prisma-count.py # PRISMA flow counts and consistency checks
-│ ├── table1.py # Table 1 generator (baseline characteristics)
-│ └── analysis-template.py # Statistical analysis template (t-test, logistic, survival)
-│
-├── tests/
-│ └── test_scripts.py # Regression tests for utility scripts
-│
-└── .github/workflows/
- └── tests.yml # CI: syntax checks + regression tests
-```
+Every phase is guarded by a quality gate. If the gate returns **FAIL**, the system generates structured feedback, dispatches a fixer agent in `revision_mode`, and re-checks — up to 3 iterations before escalating to the user.
-**Total: 83 tracked files** (37 templates + 30 references + 8 scripts + tests + CI + root docs/config)
-
-## Workflow (10 Phases)
+### 8 Quality Gates
-| Phase | Description | Key Operations |
-|-------|-------------|----------------|
-| **0** | Project Initialization | Journal requirements lookup, reporting guideline selection, directory generation, data management & analysis |
-| **1** | Literature Search | PubMed/Google Scholar search, literature matrix creation |
-| **2** | Outline | Paper skeleton design (user approval required) |
-| **2.5** | Tables & Figures | Design tables/figures before writing prose |
-| **3** | Drafting | Methods → Results → Intro P3 + Conclusion → Discussion → Intro P1-2 → Abstract → Title |
-| **4** | Humanize | AI writing pattern removal (EN 18 + JP 13 patterns) |
-| **5** | References | Citation formatting, deduplication, existence verification |
-| **6** | Quality Review | Cross-section verification, reporting guideline compliance |
-| **7** | Pre-Submission | Cover letter, title page, declarations, final checklist |
-| **8** | Revision | Reviewer comment organization, response letter, revision implementation |
-| **9** | Post-Acceptance | Proof review (24-72 hr), correction submission, post-publication tasks |
-| **10** | Rejection & Resubmission | Assessment, quick reformat, cascading submission strategy |
+Literature (≥10 papers, valid DOIs) → Outline (IMRAD + citations mapped) → Tables/Figures → Section draft score → Humanize (high-priority AI patterns = 0) → References (no fabrication / orphans) → Cross-section consistency → Submission package.
-## Reporting Guidelines (20+)
+### Team Mode: 7 Parallel Agents (v3.0)
-CONSORT 2025, STROBE, PRISMA 2020, CARE, STARD 2015, SQUIRE 2.0, SPIRIT 2025, TRIPOD+AI 2024, ARRIVE 2.0, CHEERS 2022, MOOSE, TREND, SRQR, COREQ, AGREE II, RECORD, STREGA, ENTREQ, PRISMA-ScR, GRADE
+| Agent | Role |
+|-------|------|
+| `paper-lit-searcher` | Database-specific literature search |
+| `paper-table-figure-planner` | Table and figure design |
+| `paper-section-drafter` | Section drafting |
+| `paper-humanizer` | AI writing pattern removal |
+| `paper-ref-builder` | Citation collection and verification |
+| `paper-section-reviewer` | Per-section quality check |
+| `paper-quality-gate` | Cross-section consistency + final verdict |
+
+## Repository Map
+
+| Path | What |
+|------|------|
+| [`SKILL.md`](SKILL.md) | Main workflow definition |
+| [`docs/`](docs/) | GitHub Pages landing |
+| [`examples/case-studies/`](examples/case-studies/) | Public case study |
+| [`templates/`](templates/) | Section / project / CARE / SR templates |
+| [`references/`](references/) | Humanizer, adversarial, guidelines, journals… |
+| [`scripts/`](scripts/) | Compile, word-count, table1, SR utilities |
+| [`LAUNCH.md`](LAUNCH.md) | Posting kit (X JP/EN, Show HN) |
+| [`SECURITY.md`](SECURITY.md) | PHI / network / permissions |
+
+Full file tree and phase tables remain in [`SKILL.md`](SKILL.md) and the templates/references trees (37 templates · 30 reference docs · 8 scripts).
## Language Support
| Language | Coverage |
|----------|----------|
| **English** | All templates and guides, 18 AI writing detection patterns |
-| **Japanese** | All templates bilingual (EN/JP), 13 AI writing detection patterns, である-style |
-
-## AI Writing Detection (Humanizer)
-
-A dedicated phase (Phase 4) to remove AI-generated writing patterns from academic manuscripts.
-
-- **English**: 18 patterns (significance inflation, AI vocabulary, filler phrases, etc.)
-- **Japanese**: 13 patterns (symbol overuse, rhythm monotony, academic-specific issues)
-- Section-specific priority patterns
-- Before/after examples included
-
-## Master Reference List
-
-`references/master-reference-list.md` contains 100+ URLs organized in 13 categories:
-
-1. Author Guidelines (ICMJE, EQUATOR, etc.)
-2. Reporting Guidelines (CONSORT, STROBE, etc.)
-3. Ethics & Registration (ClinicalTrials.gov, UMIN, etc.)
-4. Statistics (SAMPL, Cochrane, etc.)
-5. Literature Databases (PubMed, Google Scholar, etc.)
-6. Reference Managers (Zotero, Mendeley, etc.)
-7. Submission Portals (ScholarOne, etc.)
-8. AI Disclosure (ICMJE, Nature policies, etc.)
-9. Open Access (DOAJ, Sherpa Romeo, etc.)
-10. Writing Support (editing services, etc.)
-11. Figure/Table Tools (BioRender, GraphPad, etc.)
-12. Journal Author Instructions (major journals)
-13. Japanese Resources (Ichushi, CiNii, etc.)
-
-## Installation
-
-Clone this repository into the Claude Code skills directory:
-
-```bash
-git clone https://github.com/kgraph57/paper-writer-skill.git ~/.claude/skills/paper-writer
-```
-
-Register the skill in Claude Code settings:
-
-```json
-// Add to "skills" in ~/.claude/settings.json
-{
- "skills": {
- "paper-writer": {
- "path": "~/.claude/skills/paper-writer"
- }
- }
-}
-```
+| **Japanese** | Bilingual templates, 13 AI writing detection patterns, である-style |
## Requirements
-- [Claude Code](https://claude.ai/code) CLI
-- WebSearch / WebFetch (used for literature search)
-- Python 3 for utility scripts
-- Python packages for analysis/PDF utilities: `python -m pip install -r requirements.txt`
+- [Claude Code](https://claude.ai/code) CLI or another agent that loads `SKILL.md`
+- WebSearch / WebFetch (literature)
+- Python 3 for optional utility scripts
+- `python -m pip install -r requirements.txt` for analysis/PDF helpers
## Development
@@ -397,15 +150,20 @@ python -m unittest discover -s tests -v
## License
-Private repository.
+[MIT](LICENSE) — Copyright (c) 2026 KEN.
## Versions
-- **v3.2.0** (2026-03-05) — Research project folder management: comprehensive directory restructuring
-- **v3.1.0** (2026-03-05) — Autonomous Stage-Gate System: 8 quality gates with auto-fix loops
-- **v3.0.0** (2026-03-05) — Team Mode: 7 parallel agents for concurrent execution
-- **v2.1.0** (2026-02-17) — Data management & analysis integration, 4 new files
-- **v2.0.0** (2026-02-17) — Full lifecycle coverage, 16 new files, 10 phases
-- **v1.0.0** (2026-02-17) — Structural improvements, 6 new files, 5 paper types
+- **v3.2.0** — Research project folder management
+- **v3.1.0** — Autonomous Stage-Gate System
+- **v3.0.0** — Team Mode (7 parallel agents)
See [CHANGELOG.md](CHANGELOG.md) for details.
+
+---
+
+
+
+If you want manuscripts that survive review — and refuse to lie about data — **[★ Star the repo](https://github.com/kgraph57/paper-writer-skill)** and install it on your agent.
+
+
diff --git a/SECURITY.md b/SECURITY.md
new file mode 100644
index 0000000..c897d5e
--- /dev/null
+++ b/SECURITY.md
@@ -0,0 +1,56 @@
+# Security Policy
+
+## Normal Skill Behavior
+
+This package is a documentation-first Agent Skill for medical/scientific
+manuscript writing. Unlike zero-network skills, it **intentionally uses network
+access** for literature work: WebSearch/WebFetch and literature APIs (PubMed,
+OpenAlex, Europe PMC, Semantic Scholar) during Phase −1 novelty checks, Phase 1
+literature search, and Phase 5 citation verification. No credentials are
+required for any of these.
+
+The utility scripts under `scripts/` are optional. They read local files, write
+local Markdown/plot outputs, and make no network calls. Analysis and PDF
+utilities use the Python packages listed in `requirements.txt`.
+
+## Clinical Data Handling — the hard rules
+
+This skill is built for clinicians working with real patient data. The data
+rules below mirror `templates/data-management.md` and the AI-for-Science model
+(`references/ai-for-science-model.md`):
+
+- **Raw clinical data stays local. Always.** Generated project directories keep
+ original data under `data/raw/`, which is treated as read-only and is
+ **gitignored** — it must never be committed or pushed anywhere.
+- **Never commit PHI.** Only de-identified, processed data belongs in
+ `data/processed/`. De-identification happens before anything leaves the raw
+ folder.
+- **Never paste identifiable patient information into any AI chat**, including
+ the agent running this skill. Work from de-identified extracts.
+- **AI never originates data.** The skill must never fabricate a data point,
+ participant, or result (📊 DATA sovereignty). Any output that appears to
+ contain invented data is a bug — report it.
+
+## Permissions
+
+| Capability | Used | Notes |
+| --- | --- | --- |
+| Network access | Yes | Literature APIs and web search only; no telemetry |
+| Filesystem write | Yes | Manuscript project directories and script outputs |
+| External tools | Optional | Python packages from `requirements.txt`; pandoc for docx/pdf compile |
+| Credentials | No | No API keys required |
+| Background execution | No | |
+
+## Safety Rules
+
+- Do not add hidden scripts or install-time automation.
+- Do not add new network destinations without documenting them here.
+- Do not embed real patient data — even "harmless" fragments — in examples,
+ tests, or case studies. All repo examples are illustrative and PHI-free.
+- Do not weaken the 💡 IDEA / 📊 DATA human-sovereignty gates in SKILL.md.
+
+## Reporting
+
+Open a GitHub issue for suspected vulnerabilities, unsafe instructions, or
+hidden behavior. Do not include patient data or other confidential material in
+public reports.
diff --git a/docs/.nojekyll b/docs/.nojekyll
new file mode 100644
index 0000000..e69de29
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..d65f7f9
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,326 @@
+
+
+
+
+
+ Paper Writer Skill — Not a manuscript factory. A research engine.
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+ From clinical spark to submission-ready IMRAD — with Discovery
+ gates, stage-gated drafting, EN+JP humanizing, and an adversarial
+ review that can KILL a weak claim before any
+ journal sees it. Two things stay human: the 💡 IDEA and the 📊 DATA.
+
+ Works with Claude Code and other agents that load
+ SKILL.md. Network used for literature — not for
+ telemetry.
+
+
+
+
+
+
+
+
+
+ agent · paper-writer
+
+
+
+ You
+
Write a case report from this spark: unexplained hypoglycemia after GLP-1 start in a non-diabetic adult. Data is de-identified and IRB-cleared.
+
+
+ Paper Writer
+
Phase −1 Discovery
+Forging FINER questions… novelty check against live literature…
+
+GATE · IDEA — three candidate questions ranked.
+Human must pick the 💡 IDEA before any prose is drafted.
+
+GATE · DATA — confirming 📊 DATA is human-origin,
+de-identified, and never invented by the model.
+
+
+ You
+
Lock Q2. CARE case report. Target: BMJ Case Reports. EN.
+
+
+ Paper Writer
+
Plan locked · CARE checklist armed
+Project scaffold ready: 00_literature/ · 01_outline.md · sections/ · ethics/
+
+Next: literature matrix → outline approval → tables before prose.
+No manuscript factory mode — gates stay on.
+
+
+
+
+
Illustrative demo — no patient data. Gates are real.
+
+
+
+
+
+
+ Non-negotiable
+
Human stays sovereign on two things
+
+ Everything else can be drafted, checked, and red-teamed by the agent.
+ These two cannot be delegated away.
+
+
+
+
💡 IDEA
+
+ What is worth asking, what it means, and what is ethical.
+ Discovery forges candidates; the human locks the question.
+
+
+
+
📊 DATA
+
+ Real, IRB-approved, never machine-originated. Raw clinical data
+ stays local and gitignored. The skill never invents numbers.
+
+
+
+
+
+
+
+
+ Lifecycle
+
From Discovery to revision — with gates
+
+ Ten phases. Eight quality gates with auto-fix loops. Adversarial
+ review can send a claim back to Discovery with a KILL.
+
+ An illustrative CARE case-report spark (PHI-free) walks through
+ question forge, a naive “just write it” abstract vs. the gated path,
+ two humanizer fixes, and an overclaim the adversarial review kills.
+