Ralphtrans

Skill WALKERKILLER/Look-Tongji-Notes/skills/ralphtrans

Transcribing Lessons from Tongji Look Platform to Notes with Agent Skill.

Install

npx -y skills add WALKERKILLER/Look-Tongji-Notes --skill ralphtrans

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Batch transcribe ALL playable lectures for a course in a persistent loop. Uses a JSON state file for checkpoint/resume. Runs until every lecture is transcribed or marked failed.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

1.8 KB, as published. Nobody here has run it

Ralph Batch Transcribe

Batch transcribe all playable lectures for a course with checkpoint/resume.

When to Use

User says /ralphtrans or "batch transcribe this course".
User wants to transcribe an entire course in one go.

Workflow

Start batch transcription:

python "<SKILL_DIR>/../../scripts/look_tongji.py" batch-transcribe --course-id "<ID>"

The CLI:
- Loads all playable lectures for the course.
- Creates/reads batch_state.json in the workspace to track progress.
- Transcribes lectures one by one, updating state after each.
- Retries failed lectures up to --max-retries times.
- Prints a summary when all lectures are done or failed.
Interrupt & Resume:
- Press Ctrl+C to safely stop. State is saved.
- Re-run the same command to resume from pending lectures.

State File

batch_state.json structure:

{
  "course_id": "xxx",
  "started_at": "ISO8601",
  "updated_at": "ISO8601",
  "lectures": [
    {"sub_id": "xxx", "sub_title": "xxx", "status": "pending|done|failed", "attempts": 0, "error": null}
  ]
}

After Completion

Run /note for each transcribed lecture to generate study notes.
Run /wiki to rebuild and serve the course site.

Where `<SKILL_DIR>` Points

<SKILL_DIR> is the directory containing this SKILL.md. Shared scripts (look_tongji.py, timeline_tools.py, tongji_backend/) and references live two levels up in the repository root (<SKILL_DIR>/../../scripts/ and <SKILL_DIR>/../../references/).