{
  "markdown": "# paper-to-course\n\n> Transform any academic paper into a beautiful, interactive single-page HTML course.\n\nA [Claude Code](https://claude.ai/code) skill that converts research papers into self-contained interactive courses — with scroll-based navigation, formula breakdowns, literature timelines, method comparisons, ablation diagrams, and comprehension quizzes.\n\n**Target users:** researchers who need to quickly understand a paper's contributions, and students/newcomers learning a new field through the lens of a specific paper.\n\n## Quick Start\n\n### 1. Install the skill\n\nCopy this entire folder to your Claude Code skills directory:\n\n```bash\ncp -r paper-to-course ~/.claude/skills/\n```\n\n### 2. Use it\n\nOpen any project in Claude Code (or a standalone conversation), then say:\n\n```\nTurn this paper into a course\n```\n\nPoint it at a PDF or LaTeX source, and it will:\n\n1. Read and analyze the paper structure\n2. Design a 6-module curriculum\n3. Generate HTML modules with interactive elements\n4. Bundle everything into a single `index.html`\n\n### 3. Open the course\n\n```bash\nopen index.html   # macOS\nxdg-open index.html   # Linux\n```\n\nNo server required — it's a fully self-contained HTML file.\n\n## What You Get\n\nEach course includes **7 interactive element types**:\n\n| Element | What it does |\n|---------|-------------|\n| **Formula Breakdown** | Math formulas translated line-by-line into plain English |\n| **Literature Timeline** | Animated history of the field's key milestones |\n| **Comparison Table** | Hover to see detailed trade-off analysis between methods |\n| **Ablation Diagram** | Visual ablation study showing each component's contribution |\n| **Method Chat** | Animated component conversations explaining how the method works |\n| **Comprehension Quiz** | Multiple-choice questions to test your understanding |\n| **Glossary Tooltips** | Hover any technical term for a plain-English definition |\n\n## Course Modules\n\nEvery paper course follows this 6-module structure:\n\n1. **Problem & Motivation** — Why does this matter? What's the bottleneck?\n2. **Literature Timeline** — How did the field evolve? Key breakthroughs?\n3. **SOTA Comparison** — What are the current主流方法? Pros and cons?\n4. **Method Deep-Dive** — Architecture, formulas, algorithm flow\n5. **Experiments & Results** — Benchmarks, ablations, SOTA comparisons\n6. **Limitations & Future Work** — Open problems, next steps\n\n## File Structure\n\n```\npaper-to-course/\n├── SKILL.md                  # Claude Code skill instructions\n├── README.md                 # This file\n├── LICENSE                  # MIT License\n└── references/\n    ├── styles.css           # Complete design system + paper-specific components\n    ├── main.js              # Interactive engine (animations, quizzes, tooltips)\n    ├── build.sh             # HTML bundler\n    ├── _base.html           # HTML template header\n    ├── _footer.html         # HTML template footer\n    └── paper-elements.md    # HTML implementation patterns for all 7 element types\n```\n\n## Design\n\n- **Aesthetic:** Warm \"developer notebook\" — off-white (#FAF7F2) + coral accent (#D94F30)\n- **Fonts:** Bricolage Grotesque (headings) · DM Sans (body) · JetBrains Mono (formulas/code)\n- **Output:** Single `index.html` — no dependencies, works offline, mobile-friendly\n\n## Requirements\n\n- [Claude Code](https://claude.ai/code) (any plan)\n- A paper in PDF or LaTeX format\n\n## Extending with Other AI Coding Tools\n\npaper-to-course is a Markdown skill file — it works wherever AI coding tools support custom instructions or skills.\n\n### Claude Code (Recommended)\n\nCopy the skill to your Claude Code skills directory:\n\n```bash\ncp -r paper-to-course ~/.claude/skills/\n```\n\nThen add to your VS Code settings (`~/.config/Code/User/settings.json`):\n\n```json\n{\n  \"claudeCode.skills\": [\n    {\n      \"name\": \"paper-to-course\",\n      \"description\": \"📚 论文 → 交互式课程（HTML + PPT + 笔记）\",\n      \"path\": \"/path/to/paper-to-course/SKILL.md\"\n    }\n  ]\n}\n```\n\nReload VS Code (`Ctrl+Shift+P` → \"Reload Window\"). Then in Claude Code chat:\n\n```\n/paper-to-course /path/to/your-paper.pdf\n```\n\n### VS Code Copilot (Native)\n\nIf your VS Code workspace has a `.claude/` directory, place `paper-to-course/` inside it:\n\n```bash\nmkdir -p ./.claude/skills/\ncp -r /path/to/paper-to-course ./.claude/skills/\n```\n\nAdd to workspace `.vscode/settings.json`:\n\n```json\n{\n  \"claudeCode.skills\": [\n    {\n      \"name\": \"paper-to-course\",\n      \"description\": \"📚 论文 → 交互式课程\",\n      \"path\": \".claude/skills/paper-to-course/SKILL.md\"\n    }\n  ]\n}\n```\n\n### GitHub Copilot Chat\n\nGitHub Copilot Chat supports custom instructions via workspace `CLAUDE.md` or `.github/copilot-instructions.md`. Reference the skill:\n\n1. Copy `paper-to-course/` to your project:\n\n```bash\ncp -r /path/to/paper-to-course ./vendor/\n```\n\n2. Add to `.github/copilot-instructions.md`:\n\n```\n# Paper-to-Course\nWhen asked to study or understand a paper, use the instructions in ./vendor/paper-to-course/SKILL.md\nto generate an interactive HTML course, Markdown notes, and PPTX slides.\n```\n\n3. In GitHub Copilot Chat, ask:\n\n```\n@paper-to-course /path/to/paper.pdf\n```\n\nOr simply:\n\n```\nStudy this paper and generate a course: <attach PDF>\n```\n\n### Codex (OpenAI) / Agentic Tools\n\nCodex and similar agentic tools that support `npx skills add`:\n\n```bash\n# Option A: If you have a public GitHub repo for paper-to-course\nnpx skills add your-username/paper-to-course\n\n# Option B: Clone and install locally\ngit clone https://github.com/your-username/paper-to-course.git\ncd paper-to-course\n# Follow the tool's local install instructions (usually: point to SKILL.md)\n```\n\n### openclaw\n\n```bash\n# Method A: Copy to openclaw skills directory\ncp -r paper-to-course ~/.openclaw/skills/\n\n# Method B: Via openclaw Web IDE\n# Settings → Skills → Add Skill → point to paper-to-course/SKILL.md\n```\n\nThen in openclaw:\n\n```\n/paper-to-course /path/to/paper.pdf\n```\n\n### Cline / Roo Code / Other VS Code AI Extensions\n\nMost VS Code AI extensions respect the same `claudeCode.skills` setting or read `.md` skill files:\n\n```bash\n# Copy to workspace\ncp -r paper-to-course ./.claude/skills/\n\n# Or reference it in your project CLAUDE.md:\necho \"Use paper-to-course/SKILL.md for paper study tasks\" >> CLAUDE.md\n```\n\n---\n\n## License\n\nMIT License — free to use, modify, and distribute.\n",
  "bytes": 6279,
  "sha": "e2cde6b16281600440d3d98b0c74f65b284104949092ef251378f6354dd7986d",
  "repo_slug": "kaguratart/paper-to-course",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_kaguratart_paper_to_course_paper_to_cour_4fd29438/readme"
}