Agent skill

Confusion Tracker

by ZeKaiNie in ZeKaiNie/universal-examprep-skill

教学过程中自动捕获和记录学习者的概念疑难点("为什么/是什么/怎么推/什么意思"类型的问题),保存到进度文件的"概念疑难点记录"区,形成考前回顾清单。

MITAuto-check passedEducation

Install Confusion Tracker

skills CLI
$ npx skills add ZeKaiNie/universal-examprep-skill --skill confusion-tracker -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZeKaiNie/universal-examprep-skill confusion-tracker --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZeKaiNie/universal-examprep-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/full/skills/confusion-tracker .claude/skills/confusion-tracker && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
confusion-tracker
GitHub stars
303
Token cost
~1.5k tokens
SKILL.md length
704 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

教学过程中自动捕获和记录学习者的概念疑难点("为什么/是什么/怎么推/什么意思"类型的问题),保存到进度文件的"概念疑难点记录"区,形成考前回顾清单。

  • Works in 4 steps: Detect — decide whether the follow-up is… → Answer — give a concise, clear… → Record — persist the confusion: 关联章节 /… → …
  • Tasks that involve Study guides and flashcards
  • SKILL.md covers Purpose, Activation, Inputs and Workflow, plus 3 more sections
  • Calls python

What it does

Confusion Tracker is an agent skill from ZeKaiNie/universal-examprep-skill. 教学过程中自动捕获和记录学习者的概念疑难点("为什么/是什么/怎么推/什么意思"类型的问题),保存到进度文件的"概念疑难点记录"区,形成考前回顾清单。

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Education, covering Study guides and flashcards. It works with Python. The repository describes itself as: Exam Cram Coach · 跨会话记忆与讲义溯源防幻觉的极速备考教练 | AI exam-prep tutor for Claude Code, Cursor, Codex, Antigravity: teaches from slides with page citations, crops figures, quizzes with real…. The licence is MIT.

When your agent uses it

  • Tasks that involve Study guides and flashcards

Example prompts

  • “为什么/是什么/怎么推/什么意思”
  • “概念疑难点记录”
  • “/confusion-tracker”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Detect — decide whether the follow-up is a concept question (not a quiz item or its answer).
  2. Answer — give a concise, clear explanation grounded in the current wiki chapter. Label the source: 🟢 来自资料 for material-sourced content…
  3. Record — persist the confusion: 关联章节 / 疑难点 (one line) / 解答要点 (≤2 sentences) / 状态 (default 待回顾). If study_state.json is absent and Python…
  4. Confirm — tell the learner it was logged (e.g. 「已记录到疑难点」) in one short line, without breaking the teaching flow.

What it can do on your machine

Read from SKILL.md and the folder at commit b9e84f5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Confusion Tracker loads about 1.5k tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 704 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZeKaiNie/universal-examprep-skill at commit b9e84f5, republished under its MIT licence (© ZeKaiNie). 704 words, ~1,489 tokens.

Download SKILL.mdSave it as .claude/skills/confusion-tracker/SKILL.md (or your agent's skills folder).
name
confusion-tracker
description
教学过程中自动捕获和记录学习者的概念疑难点("为什么/是什么/怎么推/什么意思"类型的问题),保存到进度文件的"概念疑难点记录"区,形成考前回顾清单。
license
MIT

confusion-tracker — concept-confusion tracking

Purpose

Capture the learner's concept-level confusions (why / what / how-derived questions — not quiz answers) during tutoring and record them into the 「概念疑难点记录」 section of study_progress.md, building a pre-exam review list. Used by exam-tutor (while teaching) and exam-review (during the final sweep).

Activation

  • During tutoring, when the learner asks a concept question matching: 「为什么…?」/「…是什么、什么意思?」/「这个公式怎么推、怎么来的?」/「…的重点是什么?」/「讲一下…」, or any clarification follow-up that is not a quiz answer.
  • Skip for: pure quiz answering (right or wrong), and chit-chat that needs no concept explanation.

Inputs

  • The progress-file path (e.g. study_progress.md), read at session start.
  • The current chapter/phase name being taught.

Workflow

  1. Detect — decide whether the follow-up is a concept question (not a quiz item or its answer).
  2. Answer — give a concise, clear explanation grounded in the current wiki chapter. Label the source: 🟢 来自资料 for material-sourced content, 🟡 AI补充,可能与你老师讲的不完全一致 for AI-supplied background. Never present AI-added content as the teacher's.
  3. Record — persist the confusion: 关联章节 / 疑难点 (one line) / 解答要点 (≤2 sentences) / 状态 (default 待回顾). If study_state.json is absent and Python works, first run python "${CLAUDE_SKILL_DIR}/scripts/update_progress.py" --workspace <ws> init. The normal and ONLY state-backed write path is then python "${CLAUDE_SKILL_DIR}/scripts/update_progress.py" --workspace <ws> add-confusion --chapter <ch> --note <疑难点/解答要点> — the md table is a generated view and a hand-appended row is lost on the next render. Only when Python truly cannot run may the no-Python fallback append directly to the 「## 💡 概念疑难点记录」 table in study_progress.md, auto-incrementing the 序号 column. A nonzero state command while Python runs is a fail-loud write failure, not permission to hand-edit.
    • Persist-first (notebook CLI) — the state row stays exactly as above; ADDITIONALLY persist the full explanation itself (step 2's answer, provenance labels included) so it survives outside chat: echo <explanation body> | python "${CLAUDE_SKILL_DIR}/scripts/notebook.py" --workspace <ws> add-entry --chapter <ch> --type confusion --id <slug> --title <confusion gist> (body via STDIN; same --id replaces in place; notebook/index.md rebuilds; the script resolves from the skill package root). The receipt line then carries the pack-provided link line (zh 「完整解答:notebook/chNN.md#<anchor>|目录:notebook/index.md」, en Full explanation: notebook/chNN.md#<anchor> | Index: notebook/index.md). On a failed notebook write, TELL the student (the chat explanation already delivered stands as the copy); file-less clients keep chat-only output per exam-cram's capability dispatch.
  4. Confirm — tell the learner it was logged (e.g. 「已记录到疑难点」) in one short line, without breaking the teaching flow.
Show full SKILL.md (333 more words)Show less

Output Contract

  • Persist one confusion record (关联章节 / 疑难点 / 解答要点 / 状态) through update_progress.py add-confusion; initialize state first when Python works. Only a true no-Python fallback appends one row to the 「## 💡 概念疑难点记录」 table in study_progress.md (序号 auto-increments).
  • Persist-first default: the full confusion explanation is ALSO written into notebook/chNN.md via the notebook CLI (--type confusion, Workflow step 3) — the state row records that the confusion exists, the notebook entry preserves the explanation itself; the receipt carries the pack-provided link line. File-less clients keep chat-only output.
  • During the final sweep, read the confusion records and have the learner restate each: update 状态 in place — 待回顾 → 已回顾 when explained correctly; keep 待回顾 and re-explain otherwise. Never overwrite other skills' writes.
  • Student-facing output defaults to English (Simplified Chinese if the student opened in Chinese); the persisted study_state.json.language code (zh/en/bilingual) switches it per exam-cram's dispatch rule with single-language purity.

Language packs

Student-visible wording for this skill lives in per-language packs — load the one matching study_state.json.language BEFORE emitting any student-visible output:

Boundaries

  • Structured progress state: when study_state.json exists it is the SINGLE SOURCE OF TRUTH — record via python "${CLAUDE_SKILL_DIR}/scripts/update_progress.py" --workspace <ws> add-confusion, update review status via set-confusion-status --id <qid>|--index <N> --status 已回顾/待回顾; never hand-patch the generated study_progress.md. If the state write fails, TELL the user; never continue as if it saved.
  • Only record concept questions; never quiz or grade (that is exam-quiz).
  • Concept answers carry the canonical provenance labels (🟢 来自资料 / 🟡 AI补充,可能与你老师讲的不完全一致 / ⚠️ AI生成答案,非老师/教材提供); never disguise AI-added content as teacher-provided.
  • Share the progress state with exam-review: in state-backed workspaces both skills go through update_progress.py (append via add-confusion, status via set-confusion-status); only a true no-Python md-only workspace appends/updates study_progress.md in place. Never overwrite other skills' writes.

© ZeKaiNie, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in full/skills/confusion-tracker of ZeKaiNie/universal-examprep-skill.

Open the folder on GitHubat commit b9e84f5

Compare with similar skills

Confusion Tracker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Confusion Tracker compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Confusion Tracker this skillZeKaiNie/universal-examprep-skill303—~1.5kAutomated safety check: PassMIT
Pre Pushartcc/freelingo165—~732Automated safety check: PassAGPL-3.0
YouTube Talk Notetakerdair-ai/dair-academy-plugins614—~2.3kAutomated safety check: PassMIT
DeepTutor CLIHKUDS/DeepTutor41k—~2.8kAutomated safety check: PassApache-2.0
Deep Reading Analystginobefun/deep-reading-analyst-skill3544 repos~3.6kAutomated safety check: PassMIT
AI Engineering Project Tutorrohitg00/ai-engineering-from-scratch66k—~1.6kAutomated safety check: PassMIT

Similar skills

  • Pre Push

    artcc/freelingo

    A skill your agent uses when the user asks to check before pushing, pre-push, verificar antes de pushear, run all checks, or quiere validar que todo pasa antes de hacer push.

    165 GitHub stars~732 tokensUpdated yesterday
    EducationAuto-check passed
  • YouTube Talk Notetaker

    dair-ai/dair-academy-plugins

    Converts a YouTube talk into a markdown study note with slide images, a timestamped transcript and editable notes, browsable through a small local server.

    614 GitHub stars~2.3k tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed
  • DeepTutor CLI

    HKUDS/DeepTutor

    Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.

    41k GitHub stars~2.8k tokensUpdated 3 days ago
    EducationAuto-check passed
  • Deep Reading Analyst

    ginobefun/deep-reading-analyst-skill

    Comprehensive framework for deep analysis of articles, papers, and long-form content using 10+ thinking models (SCQA, 5W2H, critical thinking, inversion, mental models, first principles, systems…

    354 GitHub starsUsed in 4 repos~3.6k tokens
    EducationAuto-check passed
  • AI Engineering Project Tutor

    rohitg00/ai-engineering-from-scratch

    Tutors a learner through one stage of a hands-on AI engineering project per session: lesson, prediction, code, grader run and reflection, with hints but never full solutions.

    66k GitHub stars~1.6k tokensUpdated yesterday
    EducationAuto-check passed
  • Nihaisha

    JuneYaooo/nihaisha-nishi-tcm

    A skill your agent uses when the user asks about Ni Haisha / 倪海厦 TCM course material, especially Shang Han Lun / 伤寒论, Jingui / 金匮要略, Zhongjing Xinfa / 仲景心法, clinical cases / 临床案例 / 倪师医案, Bagang…

    2.2k GitHub stars~4k tokensUpdated 24 days ago
    EducationAuto-check passed

More from ZeKaiNie/universal-examprep-skill

All 12 skills in this repo
  • Universal Exam Cram Coach Full

    ZeKaiNie/universal-examprep-skill

    帮助学生在临考前进行结构化极速复习:解析课程资料/大纲/重点,按章节生成 wiki 知识库与标准题库,组织针对性刷题与判分,并记录复习进度和错题。当用户即将考试、需要快速复习计划、练习题、错题复盘或考前小抄时使用(关键词:期末/备考/复习/刷题/划重点/错题;exam, cram, study plan, quiz, review)。不适用于长期学习规划、与考试无关的写作或编程任务。

    303 GitHub stars~2.6k tokensUpdated 13 days ago
    Auto-check passed
  • Exam Ingest

    ZeKaiNie/universal-examprep-skill

    从学生上传的课件/大纲/老师勾的重点/真题,一键初始化并验证备考工作区:解析 PDF、DOCX、PPTX、 XLSX、常见独立图片与 txt/md,建立分章节 LLM Wiki、标准题库、结构化接管队列与进度状态;仅在 Python 确实无法运行时 明确降级为手动写盘。当工作区尚未建立、资料发生变化、或建库 readiness 被阻断时使用。

    303 GitHub stars~5.6k tokensUpdated 13 days ago
    Auto-check passed
  • Exam Study Guide

    ZeKaiNie/universal-examprep-skill

    将已经讲完但尚未完成阶段门禁的一个章节整理成强类型教材清单,并在视觉模式下编译为公式可读、图片可见、知识点与全部对应例题逐项精讲的自包含 HTML/PDF。结构化工作区准备阶段完成证据、用户说 Markdown 公式仍是 raw LaTeX、图片缺失、要含课件/作业/Quiz/模拟考试题及答案的零基础讲义,或要求打印版时使用。

    303 GitHub stars~7.6k tokensUpdated 13 days ago
    Auto-check passed
  • Universal Exam Cram Coach

    ZeKaiNie/universal-examprep-skill

    临考复习教练 / Exam cram coach. An agent skill from ZeKaiNie/universal-examprep-skill.

    303 GitHub stars~2.4k tokensUpdated 13 days ago
    Auto-check: warnings
  • Exam Audit

    ZeKaiNie/universal-examprep-skill

    只读检查一个已生成的备考工作区是否健康并报告问题,默认不做任何修改。核对 .ingest 原材料版本、 内容单元、接管队列与派生产物完整性,以及 wiki、题库、视觉证据、计划和进度的一致性。当用户怀疑 工作区有问题、建库 readiness 被阻断、或想在开始复习前体检时使用。

    303 GitHub stars~2.6k tokensUpdated 13 days ago
    Auto-check passed
  • Exam Cheatsheet

    ZeKaiNie/universal-examprep-skill

    全员通关后把 错题本+笔记本+知识点窗口+wiki 编译成考前速记小抄 cheatsheet.md(每条要点带可溯源 锚点),并在视觉产物模式或用户明确要求 PDF/打印版时按指定页数渲染成打印级 PDF:按「必背结论/公式 → 有难度例题(必要时含题面图)→ 例题解答(代入公式、保留基础过程)→ 要点解释(同类题怎么办)」 四段组织。当复习收尾、用户要「考前小抄/速记/总结/打印版」时使用。

    303 GitHub stars~1.8k tokensUpdated 13 days ago
    Auto-check passed

Works with

Categories

Questions about Confusion Tracker

What does Confusion Tracker do?

教学过程中自动捕获和记录学习者的概念疑难点("为什么/是什么/怎么推/什么意思"类型的问题),保存到进度文件的"概念疑难点记录"区,形成考前回顾清单。. Confusion Tracker is an agent skill from ZeKaiNie/universal-examprep-skill.

When should I use Confusion Tracker?

Confusion Tracker fits situations like: tasks that involve Study guides and flashcards.

How do I install Confusion Tracker in Claude Code?

Run `npx skills add ZeKaiNie/universal-examprep-skill --skill confusion-tracker -a claude-code`. Or copy the skill folder (full/skills/confusion-tracker in ZeKaiNie/universal-examprep-skill) into .claude/skills/confusion-tracker in your project. Claude Code loads it when a task matches its description.

How do I install Confusion Tracker in Codex?

Run `npx skills add ZeKaiNie/universal-examprep-skill --skill confusion-tracker -a codex`. Or copy the skill folder (full/skills/confusion-tracker in ZeKaiNie/universal-examprep-skill) into .agents/skills/confusion-tracker in your project. Codex loads it when a task matches its description.

Can I use Confusion Tracker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZeKaiNie/universal-examprep-skill --skill confusion-tracker -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/confusion-tracker, .gemini/skills/confusion-tracker, .github/skills/confusion-tracker and .opencode/skills/confusion-tracker in your project.

What does Confusion Tracker need to run?

Going by SKILL.md and its folder, Confusion Tracker needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Confusion Tracker access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Confusion Tracker safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Confusion Tracker use?

Confusion Tracker is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Confusion Tracker use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Confusion Tracker?

Skills that share tags, products or a category with Confusion Tracker: Pre Push (artcc/freelingo, 165 stars), YouTube Talk Notetaker (dair-ai/dair-academy-plugins, 614 stars), DeepTutor CLI (HKUDS/DeepTutor, 41k stars) and Deep Reading Analyst (ginobefun/deep-reading-analyst-skill, 354 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Confusion Tracker?

ZeKaiNie (a GitHub user) maintains it in ZeKaiNie/universal-examprep-skill, which has 303 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on September 28, 2026.

Source: ZeKaiNie/universal-examprep-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.