Codebase to Course
zarazhangrui/codebase-to-course
Turns a codebase into an interactive single-page HTML course for non-technical learners, with scroll modules, animated diagrams, quizzes and plain-English code translations.
Quizzes you on Claude Code in a quick or deep mode, scores your level across 10 topics and recommends what to learn next, in Chinese.
SKILL.md written in Chinese; this summary is our English description.
$ npx skills add lhfer/claude-howto-zh-cn --skill self-assessment -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install lhfer/claude-howto-zh-cn self-assessment --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/lhfer/claude-howto-zh-cn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/self-assessment .claude/skills/self-assessment && rm -rf skills-srcUse ~/.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/
Install the "self-assessment" agent skill from https://github.com/lhfer/claude-howto-zh-cn/tree/main/.claude/skills/self-assessment into .claude/skills/self-assessment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-assessment", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/lhfer/claude-howto-zh-cn/tree/main/.claude/skills/self-assessmentType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add lhfer/claude-howto-zh-cn --skill self-assessment -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install lhfer/claude-howto-zh-cn self-assessment --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/lhfer/claude-howto-zh-cn.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/self-assessment .agents/skills/self-assessment && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "self-assessment" agent skill from https://github.com/lhfer/claude-howto-zh-cn/tree/main/.claude/skills/self-assessment into .agents/skills/self-assessment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-assessment", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add lhfer/claude-howto-zh-cn --skill self-assessment -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install lhfer/claude-howto-zh-cn self-assessment --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/lhfer/claude-howto-zh-cn.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/self-assessment .cursor/skills/self-assessment && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "self-assessment" agent skill from https://github.com/lhfer/claude-howto-zh-cn/tree/main/.claude/skills/self-assessment into .cursor/skills/self-assessment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-assessment", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/lhfer/claude-howto-zh-cn.git --path .claude/skills/self-assessment--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add lhfer/claude-howto-zh-cn --skill self-assessment -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install lhfer/claude-howto-zh-cn self-assessment --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/lhfer/claude-howto-zh-cn.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/self-assessment .gemini/skills/self-assessment && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "self-assessment" agent skill from https://github.com/lhfer/claude-howto-zh-cn/tree/main/.claude/skills/self-assessment into .gemini/skills/self-assessment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-assessment", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install lhfer/claude-howto-zh-cn self-assessmentInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add lhfer/claude-howto-zh-cn --skill self-assessment -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/lhfer/claude-howto-zh-cn.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/self-assessment .github/skills/self-assessment && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "self-assessment" agent skill from https://github.com/lhfer/claude-howto-zh-cn/tree/main/.claude/skills/self-assessment into .github/skills/self-assessment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-assessment", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add lhfer/claude-howto-zh-cn --skill self-assessment -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install lhfer/claude-howto-zh-cn self-assessment --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/lhfer/claude-howto-zh-cn.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/self-assessment .opencode/skills/self-assessment && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "self-assessment" agent skill from https://github.com/lhfer/claude-howto-zh-cn/tree/main/.claude/skills/self-assessment into .opencode/skills/self-assessment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-assessment", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
self-assessmentQuizzes you on Claude Code in a quick or deep mode, scores your level across 10 topics and recommends what to learn next, in Chinese.
A Chinese-language interactive quiz that places you at Beginner, Intermediate or Advanced in Claude Code and then builds a personal learning path. The agent first asks you to pick a mode. Quick Assessment uses two multiple-choice questions covering eight abilities in about two minutes, and the number of ticked items sets the level. Deep Assessment runs five rounds of questions in about five minutes and rates ten topics separately.
Questions touch on starting Claude Code, writing CLAUDE.md memory, slash commands and skills, MCP servers, hooks, subagents and print mode with claude -p. Items you did not tick are listed as weak spots. The longer question rounds, the output templates and the topic-by-topic advice sit in three reference files that the agent opens only when it needs to show questions or build the final report.
3 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit f0da0c6. It shows what the files ask for, not the result of running them.
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.
Shell commands in SKILL.md call:
claudeFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Claude Code Self-Assessment Advisor loads about 1.7k tokens when it runs, and up to ~5.5k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 509 words of instructions outside code blocks.
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.
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.
The full file from lhfer/claude-howto-zh-cn at commit f0da0c6, republished under its MIT licence (© lhfer). 509 words, ~1,658 tokens.
.claude/skills/self-assessment/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.这是一个完整的 Claude Code 交互式自测 skill,用来评估用户在 10 个能力域上的熟练度,并据此生成个性化学习路径。
为节省上下文,较长的题目轮次、输出模板和按主题建议拆到了 references/:
references/deep-assessment-rounds.md:Deep Assessment 的 5 轮题目与评分映射references/output-templates.md:Quick / Deep 结果和学习路径模板references/topic-recommendations.md:按主题、按得分给出的具体学习建议执行时先按本文件确定流程;需要展示题目、生成最终报告或补齐主题建议时,再读取对应 reference。不要翻译或改名其中的路径、CLI flags、frontmatter key、JSON/YAML key。
使用 AskUserQuestion 提供两个选项:
如果用户选择 Quick Assessment,进入 Step 2A。 如果用户选择 Deep Assessment,进入 Step 2B。
使用两个多选问题完成快速自测,每个问题最多 4 个选项。
Question 1(header: 基础)
Prompt:
第 1/2 部分:下面哪些 Claude Code 基础能力你已经具备?
Options:
启动 Claude Code 并对话 — 我会运行 claude 并进入对话创建或编辑 CLAUDE.md — 我配置过项目或个人 memory使用过 3 个以上 slash commands — 例如 /help、/compact、/model创建过 command 或 skill — 写过 SKILL.md 或 .claude/commands/Question 2(header: 进阶)
Prompt:
第 2/2 部分:下面哪些 Claude Code 进阶能力你已经具备?
Options:
配置过 MCP server — 配置过 GitHub、数据库或其他外部数据源设置过 hooks — 配置过 ~/.claude/settings.json 里的 hooks创建或使用过 subagents — 使用过 .claude/agents/使用过 print mode(claude -p) — 用过非交互模式或 CI/CD 集成Quick 模式评分:
进入 Step 3A 输出结果,并列出未勾选项作为短板。
Deep 模式共 5 轮,每轮 1 个多选问题,每题最多 4 个选项,每轮覆盖 2 个主题。
完整题面也见 references/deep-assessment-rounds.md。如果本文件与 reference 有冲突,以本文件里的评分规则为准。
Header: 命令
Prompt:
下面哪些操作你做过?请选择所有符合的选项。
Options:
创建过 slash command 或 skill — 写过带 frontmatter 的 SKILL.md 或 .claude/commands/ 文件在 command 中使用过动态上下文 — 用过 $ARGUMENTS、$0/$1、!command、@file同时配置过项目和个人 memory — 同时配置过项目级和个人级 CLAUDE.md使用过 memory 层级功能 — 理解层级优先级、用过 .claude/rules/、path-specific rules 或 @importScoring:
Header: 自动化
Options:
安装并使用过自动触发的 skill — 使用过会按 description 自动触发的 skill控制过 skill 调用方式 — 用过 disable-model-invocation、user-invocable 或 context: fork设置过 PreToolUse 或 PostToolUse hook — 配置过常见 hook使用过进阶 hook 功能 — 用过 prompt hooks、component-scoped hooks、HTTP hooks、custom JSON outputScoring:
Header: 集成
Options:
连接过 MCP server 并使用其工具使用过进阶 MCP 功能 — project-scope .mcp.json、OAuth、Tool Search、claude mcp serve创建或配置过自定义 subagents使用过进阶 subagent 功能 — worktree 隔离、persistent memory、background tasks、agent allowlists、agent teamsScoring:
Header: 高级
Options:
用 checkpoints 做过安全试验使用过 planning mode 或 extended thinking配置过 permission modes使用过 remote / desktop / web 功能Scoring:
Header: 综合
Options:
安装或创建过 plugin使用过 plugin 进阶功能 — plugin hooks、plugin MCP、LSP、--plugin-dir在脚本或 CI/CD 中使用过 print mode使用过进阶 CLI 功能 — -c/-r、--agents、--json-schema、--fallback-model、--from-prScoring:
进入 Step 3B 输出结果。
输出必须包含:
可直接使用 references/output-templates.md 中的 Quick Assessment 结果模板。
## Claude Code 自测结果
### 你的等级:Level 1 / Level 2 / Level 3
你勾选了 **N/8** 项。
[一句鼓励性的总结]
### 你的能力概览
| 能力领域 | 状态 |
|------|--------|
| 基础 CLI 与对话 | [已掌握 / 有短板] |
| CLAUDE.md 与 Memory | [已掌握 / 有短板] |
| Slash Commands | [已掌握 / 有短板] |
| Custom Commands 与 Skills | [已掌握 / 有短板] |
| MCP | [已掌握 / 有短板] |
| Hooks | [已掌握 / 有短板] |
| Subagents | [已掌握 / 有短板] |
| Print Mode 与 CI/CD | [已掌握 / 有短板] |
### 主要短板
[对每个未勾选项,给一行说明 + 对应教程链接]
### 个性化学习路径
[按 Step 4 生成]Deep 模式要输出完整结果:
可直接使用 references/output-templates.md 中的 Deep Assessment 结果模板。
## Claude Code 自测结果
### 整体等级:[Level 1 / Level 2 / Level 3]
**总分:N/19**
[一句鼓励性总结]
### 你的能力画像
| 功能领域 | 得分 | 掌握程度 | 状态 |
|-------------|-------|---------|--------|
| Slash Commands | N/2 | 未掌握 / 基础 / 熟练(None / Basic / Proficient) | 学习 / 复习 / 已掌握(Learn / Review / Mastered) |
| Memory | N/2 | 未掌握 / 基础 / 熟练(None / Basic / Proficient) | 学习 / 复习 / 已掌握(Learn / Review / Mastered) |
| Skills | N/2 | 未掌握 / 基础 / 熟练(None / Basic / Proficient) | 学习 / 复习 / 已掌握(Learn / Review / Mastered) |
| Hooks | N/2 | 未掌握 / 基础 / 熟练(None / Basic / Proficient) | 学习 / 复习 / 已掌握(Learn / Review / Mastered) |
| MCP | N/2 | 未掌握 / 基础 / 熟练(None / Basic / Proficient) | 学习 / 复习 / 已掌握(Learn / Review / Mastered) |
| Subagents | N/2 | 未掌握 / 基础 / 熟练(None / Basic / Proficient) | 学习 / 复习 / 已掌握(Learn / Review / Mastered) |
| Checkpoints | N/1 | 未掌握 / 熟练(None / Proficient) | 学习 / 已掌握(Learn / Mastered) |
| Advanced Features | N/2 | 未掌握 / 基础 / 熟练(None / Basic / Proficient) | 学习 / 复习 / 已掌握(Learn / Review / Mastered) |
| Plugins | N/2 | 未掌握 / 基础 / 熟练(None / Basic / Proficient) | 学习 / 复习 / 已掌握(Learn / Review / Mastered) |
| CLI | N/2 | 未掌握 / 基础 / 熟练(None / Basic / Proficient) | 学习 / 复习 / 已掌握(Learn / Review / Mastered) |然后继续输出:
Deep 模式总体等级:
不要简单重复通用路线,要按短板动态生成。
具体主题建议优先参考 references/topic-recommendations.md,但要根据用户实际勾选结果裁剪,不要把所有主题机械列出来。
规则:
输出格式:
### 你的个性化学习路径
**预计时间**:约 N 小时
#### 阶段 1:[名称](约 N 小时)
**[主题]** — [从零学习 / 深入补课]
- 教程:[链接]
- 重点关注:[章节]
- 关键练习:[一个练习]
- 完成标准:[成功条件]结果给完后,再用 AskUserQuestion 让用户选择:
从第一个短板开始深入学习一个主题搭建练习项目重新评估如果用户选第一项:直接进入第一个短板主题的学习建议。 如果用户选第二项:让用户选一个主题并解释。 如果用户选第三项:根据短板组合一个练习项目。 如果用户选第四项:重新开始。
© lhfer, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 4 other files (references) in .claude/skills/self-assessment of lhfer/claude-howto-zh-cn.
Open the folder on GitHubat commit f0da0c6
Claude Code Self-Assessment Advisor 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Claude Code Self-Assessment Advisor this skilllhfer/claude-howto-zh-cn | 2.3k | — | ~1.7k | Automated safety check: Pass | MIT | |
| Codebase to Coursezarazhangrui/codebase-to-course | 5.7k | — | ~4.4k | Automated safety check: Pass | None | |
| Lesson Generatordair-ai/dair-academy-plugins | 614 | 2 repos | ~1.1k | Automated safety check: Pass | MIT | |
| Canvas Reading AnnotationX-isdoingreat/canvas-pilot | 125 | — | ~8.4k | Automated safety check: Notes | AGPL-3.0 | |
| Content Evaluation Frameworkaiskillstore/marketplace | 430 | — | ~3k | Automated safety check: Pass | None | |
| OpenMAIC Setup and ExtensionTHU-MAIC/OpenMAIC | 40k | — | ~1.7k | Automated safety check: Notes | MIT |
zarazhangrui/codebase-to-course
Turns a codebase into an interactive single-page HTML course for non-technical learners, with scroll modules, animated diagrams, quizzes and plain-English code translations.
dair-ai/dair-academy-plugins
Builds a self-contained multi-lesson course page with lesson navigation, objectives, flashcards, quizzes and source links, as plain HTML, CSS and JavaScript.
X-isdoingreat/canvas-pilot
Generic reading-annotation handler for academic-writing courses — annotates reading PDFs with color-coded highlights + margin notes + filled answer blanks per the instructor's rubric.
aiskillstore/marketplace
This skill should be used when evaluating the quality of book chapters, lessons, or educational content.
THU-MAIC/OpenMAIC
Guides setup, classroom generation and secondary development for OpenMAIC, the multi-agent interactive classroom, one confirmed phase at a time.
THU-MAIC/OpenMAIC
Maps the structure of an OpenMAIC stage document so an agent can find the right path, read it and patch quizzes, widgets, actions and project pages without guessing.
lhfer/claude-howto-zh-cn
Turns a topic and reference materials into a versioned blog draft through a fixed outline-first pipeline with per-source summaries.
lhfer/claude-howto-zh-cn
Creates, updates or audits a project's CLAUDE.md by analyzing the codebase, drafting for review and flagging anti-patterns, aiming for under 200 lines.
lhfer/claude-howto-zh-cn
Structured code review across security, performance, code quality and maintainability, with a checklist, a finding template and two Python scripts for complexity metrics.
lhfer/claude-howto-zh-cn
基于 Martin Fowler 方法论做系统化重构。Use when users ask to refactor code, improve structure, reduce technical debt, clean up legacy code, or improve maintainability.
lhfer/claude-howto-zh-cn
Runs a ten-question interactive quiz on one lesson of a Claude Code tutorial, scores it, and points out the weak spots with a review of missed questions.
lhfer/claude-howto-zh-cn
Keeps marketing copy and customer messages in one consistent brand voice, using a defined mission, tone, writing rules and lists of preferred and avoided terms.
Categories
Quizzes you on Claude Code in a quick or deep mode, scores your level across 10 topics and recommends what to learn next, in Chinese. A Chinese-language interactive quiz that places you at Beginner, Intermediate or Advanced in Claude Code and then builds a personal learning path. The agent first asks you to pick a mode.
Claude Code Self-Assessment Advisor fits situations like: finding out your current Claude Code skill level; deciding what to learn next in Claude Code; getting a personalized learning order after a short quiz.
Run `npx skills add lhfer/claude-howto-zh-cn --skill self-assessment -a claude-code`. Or copy the skill folder (.claude/skills/self-assessment in lhfer/claude-howto-zh-cn) into .claude/skills/self-assessment in your project. Claude Code loads it when a task matches its description.
Run `npx skills add lhfer/claude-howto-zh-cn --skill self-assessment -a codex`. Or copy the skill folder (.claude/skills/self-assessment in lhfer/claude-howto-zh-cn) into .agents/skills/self-assessment in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lhfer/claude-howto-zh-cn --skill self-assessment -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/self-assessment, .gemini/skills/self-assessment, .github/skills/self-assessment and .opencode/skills/self-assessment in your project.
Going by SKILL.md and its folder, Claude Code Self-Assessment Advisor needs the command-line tools its instructions call (claude).
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.
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.
Claude Code Self-Assessment Advisor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.8k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Claude Code Self-Assessment Advisor: Codebase to Course (zarazhangrui/codebase-to-course, 5.7k stars), Lesson Generator (dair-ai/dair-academy-plugins, 614 stars), Canvas Reading Annotation (X-isdoingreat/canvas-pilot, 125 stars) and Content Evaluation Framework (aiskillstore/marketplace, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
lhfer (a GitHub user) maintains it in lhfer/claude-howto-zh-cn, which has 2,307 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on August 6, 2026.
Source: lhfer/claude-howto-zh-cn on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.