# Look Tongji Notes

> 9-command agent skill suite for Tongji Look (look.tongji.edu.cn): setup, list, transcribe, take notes, manage materials, build course wiki, create cheat sheets, batch-process entire courses, and deploy course wiki to GitHub Pages.

- Skill: `walkerkiller/look-tongji-notes` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add walkerkiller/look-tongji-notes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/walkerkiller/look-tongji-notes/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: WALKERKILLER (https://skillmd.com/u/walkerkiller)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/walkerkiller/look-tongji-notes

---


# Look Tongji Notes

## Commands

| Command | What It Does | SKILL.md |
|---------|-------------|----------|
| `/setup` | Configure credentials, check dependencies (Python, Node.js, ffmpeg, vision-support, TeX), set workspace | `skills/setup/SKILL.md` |
| `/list` | List courses, search by keyword, interactive selection | `skills/list/SKILL.md` |
| `/trans` | Transcribe one lecture to SRT + TXT; optionally download slides in parallel | `skills/trans/SKILL.md` |
| `/note` | Generate study notes + timeline outline from transcript + slides | `skills/note/SKILL.md` |
| `/add` | Import supplementary materials (PDF, PPTX, DOCX) into a lecture session | `skills/add/SKILL.md` |
| `/wiki` | Build and locally serve the static course knowledge base | `skills/wiki/SKILL.md` |
| `/cheatsheet` | Generate A4 cheat sheet (LaTeX or HTML) from course notes | `skills/cheatsheet/SKILL.md` |
| `/page` | Deploy the built course wiki to GitHub Pages via gh CLI | `skills/page/SKILL.md` |
| `/ralphtrans` | Batch transcribe all lectures in a course with checkpoint/resume | `skills/ralphtrans/SKILL.md` |

Each command has its own `skills/<name>/SKILL.md` with detailed workflow instructions.

## Shared Conventions

### Credentials & Auth
- Credentials stored in `<SKILL_DIR>/.env` (git-ignored).
- Auth cache in `<SKILL_DIR>/state/`.
- Workspace config stored outside the skill tree for persistence across updates.

### Agent-Content Boundary
- The CLI fetches, transcribes, downloads, and converts artifacts.
- The agent generates timeline outlines, study notes, and cheat sheet content.
- Never pass passwords in chat. Use interactive terminal input.

### Vision Support
- Embedded at `<SKILL_DIR>/vision-support/` (Node.js 18+ required).
- `/setup` detects Node.js and configures a vision provider via `vision.mjs init`.
- Test with: `node "<SKILL_DIR>/vision-support/scripts/vision.mjs" "<image-path>"`
- Config saved to `<SKILL_DIR>/vision-support/config.json` (git-ignored).

## Quick Start

```
/setup                   # first time only
/list                    # discover courses
/trans --course-id X     # transcribe one lecture
/note --course-id X      # generate notes for one lecture
/wiki                    # serve local course wiki
/page                    # deploy course wiki to GitHub Pages
```