explaingit

haoaaa-111/taoketong

Analysis updated 2026-06-24

44TypeScriptAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

Chinese-language Next.js tool for university students that turns a class schedule screenshot into a personalized skip-class plan with per-period risk and action.

Mindmap

mindmap
  root((taoketong))
    Inputs
      Timetable screenshot
      User profile
      School guides
      Course details
    Outputs
      Per class action
      Skip risk score
      Substitute suggestion
    Use Cases
      Plan skip days
      Reduce decision fatigue
      Run as Claude skill
    Tech Stack
      Nextjs
      TypeScript
      Zod
      OpenAI API
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Self-host a skip-class planner for Chinese university students

USE CASE 2

Load the skipclass Agent Skill into Claude Code or Codex

USE CASE 3

Adapt the four-agent Modeler/Supervisor/Memory pattern for other planning tools

USE CASE 4

Use fs-store as a Markdown-table replacement for a small database

What is it built with?

Next.jsTypeScriptZodOpenAI

How does it compare?

haoaaa-111/taoketongxoriin/netmapafumu/openteam
Stars444247
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/52/5
Audiencegeneralops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs an OpenAI-compatible LLM key, base URL and model name in env before npm run dev.

MIT license, free to use, modify, and redistribute with attribution.

In plain English

Taoketong, which the README translates as Skip Class Master, is a Chinese-language tool for university students that takes a class schedule and produces a personal plan for which classes to skip and which ones to attend. The user uploads a screenshot of their timetable, a short profile of themselves, school information they have gathered, and details of the courses they already know about. The system then returns a complete and concrete plan. The stated goal is not to encourage skipping class but to reduce the time students spend agonizing over the decision. The README lays out scenarios such as an early morning class after a bad night of sleep, or a slow afternoon lecture where the student keeps switching between going and not going. The output is a three way classification per class period: can skip, sign in then leave, must attend, or find a substitute. The user makes the final call on the harder cases. Under the hood, the project is a Next.js 15 app with strict TypeScript and Zod validation, and it uses an OpenAI compatible API. The README skips a traditional database and stores everything as structured Markdown tables on disk through a module called fs-store. The agent stack has four parts. Modeler estimates roll call risk per class from teacher type, school specific rules, and past events. Supervisor turns the Modeler output into the full plan using an eight layer prompt. Memory Agent reads back user feedback about what actually happened and updates the course data and teacher templates. School Skill Generator turns scraped school guides from Jisuke or Xiaohongshu into a per school skill file. The project also ships as an Agent Skill at skills/skipclass that can be loaded into Claude Code, OpenCode, or Codex by copying it into the tool's skills folder, after which the user can say something like analyze my class schedule to trigger it. Self hosting needs npm install, an LLM API key, base URL, and model name in env, then npm run dev. The project is MIT licensed.

Copy-paste prompts

Prompt 1
Walk me through wiring taoketong to a custom OpenAI-compatible endpoint by setting LLM_API_KEY, LLM_BASE_URL and LLM_MODEL.
Prompt 2
Show me how the Supervisor eight-layer prompt is constructed in taoketong and where to edit it.
Prompt 3
Port the fs-store Markdown-table CRUD module out of taoketong into a standalone Next.js project.
Prompt 4
Install the skipclass Agent Skill into my Claude Code skills folder and trigger it on a sample timetable.
Prompt 5
Adapt the Modeler risk-scoring logic in taoketong to predict meeting attendance instead of class roll-calls.

Frequently asked questions

What is taoketong?

Chinese-language Next.js tool for university students that turns a class schedule screenshot into a personalized skip-class plan with per-period risk and action.

What language is taoketong written in?

Mainly TypeScript. The stack also includes Next.js, TypeScript, Zod.

What license does taoketong use?

MIT license, free to use, modify, and redistribute with attribution.

How hard is taoketong to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is taoketong for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.