Agent skill

Subject Learning Assistant

by cafe3310 in cafe3310/public-agent-skills

基于 memocli (memories-off) 的结构化、三层分级的学习助手。支持内容摄取、自动大纲规划(主题 - 任务 - 概念)、引导式教学以及实时的地铁图可视化

Apache-2.0Auto-check passedEducation

Install Subject Learning Assistant

skills CLI
$ npx skills add cafe3310/public-agent-skills --skill subject-learning-assistant -a claude-code

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

GitHub CLI
$ gh skill install cafe3310/public-agent-skills subject-learning-assistant --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/cafe3310/public-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills_parked/subject-learning-assistant .claude/skills/subject-learning-assistant && 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
subject-learning-assistant
GitHub stars
255
Token cost
~835 tokens
SKILL.md length
261 words
Files
5 (incl. scripts, references)
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

基于 memocli (memories-off) 的结构化、三层分级的学习助手。支持内容摄取、自动大纲规划(主题 - 任务 - 概念)、引导式教学以及实时的地铁图可视化

  • Works in 6 steps: 学习主题 (Learning Subject): 宏观领域(例如:“Zig… → 任务节点 (Topic):… → 概念 (Concept): 原子级、独立的知识单元(例如:“分配器”、“切片”)。 → …
  • Tasks that involve Tutoring and explanations
  • SKILL.md covers 核心层级, 子流程 1:内容摄取, 子流程 2:大纲规划与管理 and 子流程 3:交互式教学与熟练度管理, plus 3 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Subject Learning Assistant is an agent skill from cafe3310/public-agent-skills. 基于 memocli (memories-off) 的结构化、三层分级的学习助手。支持内容摄取、自动大纲规划(主题 - 任务 - 概念)、引导式教学以及实时的地铁图可视化

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/ref_kb.yaml`, `references/ref_prompt.md` and `scripts/server.py`).

It sits in Education, covering Tutoring and explanations. The repository describes itself as: personal agent skills for better QoL. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Tutoring and explanations

Example prompts

  • “/subject-learning-assistant”

Requirements

  • Python 3

Workflow steps

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

  1. 学习主题 (Learning Subject): 宏观领域(例如:“Zig 编程语言”)。
  2. 任务节点 (Topic): 主题内的中级逻辑模块(例如:“内存管理”、“Comptime”)。
  3. 概念 (Concept): 原子级、独立的知识单元(例如:“分配器”、“切片”)。
  4. 学习计划 (Learning Plan): 定义任务节点及其内部概念的顺序路径。
  5. 当前学习状态 (Current Learning Status): 跟踪当前活动计划和进度的单例实体。
  6. 学习日志 (Learning Log): 学习流的顺序记录。

What it can do on your machine

Read from SKILL.md and the folder at commit 6c45501. 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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Subject Learning Assistant loads about 835 tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 29 tokens; SKILL.md has 261 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~835
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from cafe3310/public-agent-skills at commit 6c45501, republished under its Apache-2.0 licence (© cafe3310). 261 words, ~835 tokens.

Download SKILL.mdSave it as .claude/skills/subject-learning-assistant/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
subject-learning-assistant
description
基于 memocli (memories-off) 的结构化、三层分级的学习助手。支持内容摄取、自动大纲规划(主题 -> 任务 -> 概念)、引导式教学以及实时的地铁图可视化
license
Apache-2.0
author
github/cafe3310
depends_on_skill
github/cafe3310/agent-skill-memories-off -> memories-off
depends_on_binary
python3

学习助手 (Subject Learning Assistant)

此技能将 Agent 转化为一名擅长结构化知识管理的教学导师。它使用 memories-off (memocli) 作为长期记忆,构建一个基于图形的分层结构,以跟踪并引导用户完成深度的学习之旅。

核心层级

  1. 学习主题 (Learning Subject): 宏观领域(例如:“Zig 编程语言”)。
  2. 任务节点 (Topic): 主题内的中级逻辑模块(例如:“内存管理”、“Comptime”)。
  3. 概念 (Concept): 原子级、独立的知识单元(例如:“分配器”、“切片”)。
  4. 学习计划 (Learning Plan): 定义任务节点及其内部概念的顺序路径。
  5. 当前学习状态 (Current Learning Status): 跟踪当前活动计划和进度的单例实体。
  6. 学习日志 (Learning Log): 学习流的顺序记录。

子流程 1:内容摄取

当用户提供教科书、论文、网页内容或长文本时触发。

  1. 消化: 提取核心任务、概念、逻辑链和关键结论。
  2. 实体创建: 使用 memocli create-entity 创建 Topic (任务节点) 和 Concept (概念) 实体。
  3. 层级映射: 使用 --add-rel-out 建立任务节点与概念之间的关系。
  4. 观察记录: 使用 memocli append-update 存储提取的细节。

子流程 2:大纲规划与管理

在启动新主题或调整计划时触发。

  1. 背景挖掘: 询问学习动机、背景(资历/经验)和偏好(理论 vs 实践)。
  2. T型拆解:
    • 横向广度: 基础任务节点及其核心概念。
    • 纵向深度: 用于解决问题和提升专业能力的进阶任务节点。
  3. 图谱同步 (强制): 你必须使用 memocli 命令构建层级结构:
    • memocli create-entity --name "主题名称" --type "学习主题"
    • memocli create-entity --name "任务名称" --type "子主题" --add-rel-in "HAS_TOPIC:主题名称"
    • memocli create-entity --name "概念名称" --type "概念" --add-rel-in "INCLUDES:任务名称"
    • memocli create-entity --name "当前计划" --type "学习计划" --reason "更新计划"
    • 使用 memocli append-update 在 学习计划 实体上追加顺序布局,格式为 子主题-任务名称: ["概念1", "概念2"]。

子流程 3:交互式教学与熟练度管理

核心交互循环。

  1. 流程记录 (强制):
    • 使用 memocli create-entity 创建 学习日志。
    • 日志命名:学习日志-YYYYMMDD-NNN。
    • 日志内容必须包含:时间戳: HH:MM 和 摘要: ...。
  2. 概念引入:
    • 扮演一名耐心、资深的导师。使用苏格拉底式引导而非直接给出答案。
    • 状态跟踪: 使用 memocli append-update 将活动中的概念标记为“状态: 正在介绍”。
  3. 熟练度调整:
    • 在概念实体中记录用户的理解情况。
    • 掌握后,更新为“状态: 已完成”。

子流程 4:实时可视化

提供进度的全局视图。仪表盘代码是预构建的静态文件;你只需要运行服务器。

  1. 执行:
    • 不要自行生成或修改 HTML/JS 文件。这是为了节省成本并避免错误。
    • 通过 ask_user 向用户提供服务器命令,以便用户在独立终端中运行。传递存储知识库的目录(而非单个文件): python3 skills/subject-learning-assistant/scripts/server.py <KB_DIR> 8000
    • Web 界面将自动获取数据并平滑地显示更新动画。

行为准则

  • 语言偏好: 你可以使用中文编写所有实体信息、概念、摘要和观察结果,确保与用户沟通一致。
  • 手册优先: 务必先使用 read_graph_manual 来了解图谱规则。
  • 原子响应: 提出问题后立即停止输出;等待用户输入。
  • 严格层级: 确保每个概念都归属于一个任务节点,每个任务节点都归属于一个主题。
  • 禁止代做功课: 引导用户共同探索答案。

最佳实践与操作经验

本节总结了在生产环境中运行此技能的经验教训,以确保跨模型的健壮执行:

  1. 关注点分离(数据 vs UI)

    • 规则: 严禁编写、修改或调试仪表盘的 HTML、JavaScript 或 Python 代码。
    • 原因: 可视化器 (server.py + index.html) 是一个静态、解耦的系统。你的唯一工作是使用 memocli 命令更改底层数据库。前端依赖 HTTP 轮询和 D3.js 过渡,自动渲染数据变化并带有平滑的动画。
  2. 地铁图渲染要求

    • 规则: 为确保中间的“知识地图”(地铁图)正确渲染,学习计划 实体必须在观察结果中包含格式精确的数组。
    • 格式:
      • 大纲: 任务大纲: ["任务1", "任务2"]
      • 任务分组: 子主题-[精确的任务名称]: ["概念1", "概念2"]
    • 原因: Python 服务器解析这些特定的字符串前缀来构建线性地铁线路。缺少连字符或名称不匹配将导致渲染失败。
  3. 状态字符串匹配

    • 规则: 严格遵守 observations 中的状态字符串。
    • 有效状态: 状态: 等待中, 状态: 正在介绍, 状态: 已完成。
    • 原因: D3.js 渲染引擎和 CSS 类根据这些精确的字符串匹配来映射节点颜色和呼吸动画。
  4. 迭代式数据变更

    • 规则: 使用 memocli create-entity 创建新的知识节点,使用 memocli append-update 推送状态变更或用户反馈。
    • 原因: 这模拟了实时的、事件驱动的学习进度,允许 UI 在其轮询周期内捕捉增量变化。

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

Files

SKILL.md and 4 other files (scripts, references) in skills_parked/subject-learning-assistant of cafe3310/public-agent-skills.

  • SKILL.md
  • references/ref_kb.yaml
  • references/ref_prompt.md
  • scripts/index.html
  • scripts/server.py

Open the folder on GitHubat commit 6c45501

Compare with similar skills

Subject Learning Assistant 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.

Subject Learning Assistant compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Subject Learning Assistant this skillcafe3310/public-agent-skills255—~835Automated safety check: PassApache-2.0
DeepTutor CLIHKUDS/DeepTutor41k—~2.8kAutomated safety check: PassApache-2.0
AI Engineering Project Tutorrohitg00/ai-engineering-from-scratch66k—~1.6kAutomated safety check: PassMIT
Hung-Yi Lee Teaching Stylevoidful/hung-yi-lee-skill1.3k—~13kAutomated safety check: PassNone
Claude Certification Tutorrohitg00/ai-engineering-from-scratch66k—~3kAutomated safety check: PassMIT
StudyVault Quiz Tutorbevibing/tutor-skills1.3k—~1.4kAutomated safety check: PassMIT

Similar skills

  • 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 today
    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 2 days ago
    EducationAuto-check passed
  • Hung-Yi Lee Teaching Style

    voidful/hung-yi-lee-skill

    Explains machine learning, LLMs, AI agents and speech modeling in a Hung-Yi Lee-inspired teaching style, drawing on a knowledge base built from his lectures and research references.

    1.3k GitHub stars~13k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Claude Certification Tutor

    rohitg00/ai-engineering-from-scratch

    Guides a learner through one of four independent Claude certification tracks with onboarding, lessons, practice labs, mock exams and remediation.

    66k GitHub stars~3k tokensUpdated 2 days ago
    EducationAuto-check passed
  • StudyVault Quiz Tutor

    bevibing/tutor-skills

    Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.

    1.3k GitHub stars~1.4k tokensUpdated 7 mo ago
    EducationAuto-check passed
  • Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.

    40k GitHub stars~1.1k tokensUpdated today
    EducationAuto-check passed

More from cafe3310/public-agent-skills

All 29 skills in this repo
  • Impeccable

    cafe3310/public-agent-skills

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    255 GitHub stars~4.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Text Watermark Fountain

    cafe3310/public-agent-skills

    A specialized skill for embedding and extracting resilient watermarks in text by manipulating sentence lengths and using Fountain Codes.

    255 GitHub stars~921 tokensUpdated 3 mo ago
    Auto-check passed
  • Obsidian Todo Collector

    cafe3310/public-agent-skills

    从 Obsidian 知识库中扫描指定时间范围内未完成事件,生成/更新未完成事件整理文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~575 tokensUpdated 3 mo ago
    Auto-check passed
  • Deep Research

    cafe3310/public-agent-skills

    一个全面、自主的深度研究框架。当用户请求对复杂主题、市场调研、技术格局进行深入的多维度调查,或需要大量网页浏览、数据合成和结构化报告的任何任务时,使用此技能。它协调子代理(subagents)并使用基于文件系统的状态管理来防止上下文膨胀。

    255 GitHub stars~996 tokensUpdated 3 mo ago
    Auto-check passed
  • Long Audio To Obsidian

    cafe3310/public-agent-skills

    将语音转写项目输出的复杂文件结构整理合并为适合 Obsidian 归档的 Markdown 文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~772 tokensUpdated 3 mo ago
    Auto-check passed
  • Markdown New

    cafe3310/public-agent-skills

    通过 markdown.new API 将网页、整站或搜索结果转换为干净的 Markdown. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~344 tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about Subject Learning Assistant

What does Subject Learning Assistant do?

基于 memocli (memories-off) 的结构化、三层分级的学习助手。支持内容摄取、自动大纲规划(主题 - 任务 - 概念)、引导式教学以及实时的地铁图可视化. Subject Learning Assistant is an agent skill from cafe3310/public-agent-skills.

When should I use Subject Learning Assistant?

Subject Learning Assistant fits situations like: tasks that involve Tutoring and explanations.

How do I install Subject Learning Assistant in Claude Code?

Run `npx skills add cafe3310/public-agent-skills --skill subject-learning-assistant -a claude-code`. Or copy the skill folder (skills_parked/subject-learning-assistant in cafe3310/public-agent-skills) into .claude/skills/subject-learning-assistant in your project. Claude Code loads it when a task matches its description.

How do I install Subject Learning Assistant in Codex?

Run `npx skills add cafe3310/public-agent-skills --skill subject-learning-assistant -a codex`. Or copy the skill folder (skills_parked/subject-learning-assistant in cafe3310/public-agent-skills) into .agents/skills/subject-learning-assistant in your project. Codex loads it when a task matches its description.

Can I use Subject Learning Assistant 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 cafe3310/public-agent-skills --skill subject-learning-assistant -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/subject-learning-assistant, .gemini/skills/subject-learning-assistant, .github/skills/subject-learning-assistant and .opencode/skills/subject-learning-assistant in your project.

What does Subject Learning Assistant need to run?

Going by SKILL.md and its folder, Subject Learning Assistant needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Subject Learning Assistant 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 Subject Learning Assistant 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Subject Learning Assistant use?

Subject Learning Assistant is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Subject Learning Assistant use?

About 835 tokens (SKILL.md is roughly 3.3k 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 11k tokens, read only when the agent opens those files.

What are the alternatives to Subject Learning Assistant?

Skills that share tags, products or a category with Subject Learning Assistant: DeepTutor CLI (HKUDS/DeepTutor, 41k stars), AI Engineering Project Tutor (rohitg00/ai-engineering-from-scratch, 66k stars), Hung-Yi Lee Teaching Style (voidful/hung-yi-lee-skill, 1.3k stars) and Claude Certification Tutor (rohitg00/ai-engineering-from-scratch, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Subject Learning Assistant?

cafe3310 (a GitHub user) maintains it in cafe3310/public-agent-skills, which has 255 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on June 26, 2026.

Source: cafe3310/public-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.