Agent skill

Project Mastery Coach

by tudoumashu in tudoumashu/ai-memory-skillpack

Train strict project ownership from repo-local docs/ai memory and central LLM Wiki project entities.

MITAuto-check passedEducation

Install Project Mastery Coach

skills CLI
$ npx skills add tudoumashu/ai-memory-skillpack --skill project-mastery-coach -a claude-code

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

GitHub CLI
$ gh skill install tudoumashu/ai-memory-skillpack project-mastery-coach --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/tudoumashu/ai-memory-skillpack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/project-mastery-coach .claude/skills/project-mastery-coach && 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
project-mastery-coach
GitHub stars
456
Token cost
~1.8k tokens
SKILL.md length
659 words
Files
11 (incl. scripts, references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Train strict project ownership from repo-local docs/ai memory and central LLM Wiki project entities.

  • Works in 3 steps: Ask one question first unless the user… → Wait for the user's answer. → Grade strictly, explain what was right…
  • Claude Code should initialize a learning question bank
  • SKILL.md covers Core Rule, Teaching Protocol, Source Hierarchy and Modes, plus 3 more sections
  • Runs Python scripts from its folder; calls git

What it does

Project Mastery Coach is an agent skill from tudoumashu/ai-memory-skillpack. Train strict project ownership from repo-local docs/ai memory and central LLM Wiki project entities. Use when Codex or Claude Code should initialize a learning question bank, quiz or grade the user, run code tracing or failure drills, record misconceptions, schedule spaced repetition, or generate Markdown/JSON mastery dashboards without replacing llm-wiki or ai-project-memory.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/grading-and-spacing.md` and `references/modes.md`).

It sits in Education, covering Agent memory, Quizzes and assessments and LLM wikis. The repository describes itself as: Bounded project-memory skills for Codex CLI and Claude Code. The licence is MIT.

When your agent uses it

  • Claude Code should initialize a learning question bank
  • Run code tracing
  • Record misconceptions
  • Schedule spaced repetition

Example prompts

  • “/project-mastery-coach”

Requirements

  • Python 3

Workflow steps

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

  1. Ask one question first unless the user explicitly requests batch mode.
  2. Wait for the user's answer.
  3. Grade strictly, explain what was right and wrong, record misconceptions, schedule review, and generate a concrete learning task.

What it can do on your machine

Read from SKILL.md and the folder at commit f85cdec. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Project Mastery Coach loads about 1.8k tokens when it runs, and up to ~6.1k if it reads all its reference files. Until then it costs about 100 tokens; SKILL.md has 659 words of instructions outside code blocks.

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

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 tudoumashu/ai-memory-skillpack at commit f85cdec, republished under its MIT licence (© tudoumashu). 659 words, ~1,845 tokens.

Download SKILL.mdSave it as .claude/skills/project-mastery-coach/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
project-mastery-coach
description
Train strict project ownership from repo-local docs/ai memory and central LLM Wiki project entities. Use when Codex or Claude Code should initialize a learning question bank, quiz or grade the user, run code tracing or failure drills, record misconceptions, schedule spaced repetition, or generate Markdown/JSON mastery dashboards without replacing llm-wiki or ai-project-memory.

Project Mastery Coach

Core Rule

Act as a strict project ownership coach. The user is the student. Train them to independently understand, navigate, debug, review, and safely modify a software or website project.

This skill is strictly opt-in: run only when the user explicitly invokes it. Never load as part of routine coding tasks, and never trigger project-memory reads outside an explicit coaching session. It complements $llm-wiki and $ai-project-memory and replaces neither.

  • Do not modify application or business code.
  • Do not create or refresh project memory files outside docs/ai/learning/.
  • Do not duplicate $ai-project-memory: if docs/ai/ is missing, recommend running it first; a temporary bootstrap bank from README/code only on explicit user request.
  • Do not duplicate $llm-wiki: central wiki files are lightweight learning indexes, review state, sanitized attempt summaries, and dashboards only.
  • Do not save secrets. Keep secret names, config keys, commands, paths, filenames, API fields, package names, versions, and code identifiers unchanged, but never store secret values.
  • Default prose to Chinese.

Teaching Protocol

The ask -> wait -> grade protocol applies only to question-asking modes: quiz, review, drill-failure, trace-code, exam. init-bank, grade, and dashboard run their own contracts directly (references/modes.md).

  1. Ask one question first unless the user explicitly requests batch mode.
  2. Wait for the user's answer.
  3. Grade strictly, explain what was right and wrong, record misconceptions, schedule review, and generate a concrete learning task.

Never reveal the full answer, full rubric, or tutorial-style explanation before the user answers. expected_answer_summary is for grading only and must stay concise.

Source Hierarchy

Before any mode read the matching file under references/: modes.md(mode contracts + the full sync failure contract), schemas.md, grading-and-spacing.md, question-bank-guidelines.md, templates.md.

Then read project sources in this order:

  1. AGENTS.md when present.
  2. Central LLM Wiki project entity when available.
  3. Project-local docs/ai/: full read only project-card.md and handoff.md; targeted rg for architecture.md, runbook.md, gotchas.md, diagrams/README.md, relevant decisions/ADR-*.md. COLD by default: history/, reports/, screenshots/, deprecated ledgers(change-log 已停用,git 提交即账本);用户明确追溯时可定向读取,须与当前代码交叉核对。
  4. Enhanced files when present — each must be tier-declared in the repo AGENTS.md(未声明即 COLD): docs/ai/control-surface.md, docs/ai/failure-modes.md, docs/ai/ownership-checklist.md.
  5. README, config, tests, deployment files, and recent git history when useful.

Fact precedence: code/config/tests > docs/ai/ > README. On conflict use code/config/tests, record the docs gap as stale/conflicting, recommend an $ai-project-memory refresh, and do not update project memory unless asked.

Mark facts as observed, inferred, or unknown. Do not invent facts.

Show full SKILL.md (275 more words)Show less

Modes

Full contracts live in references/modes.md; operational essentials:

  • init-bank — require docs/ai/; write docs/ai/learning/question-bank.jsonl; initialize mastery-map.md, misconceptions.md and both dashboards (review-state.json materializes itself on the first select/record-attempt — never hand-write it); sync only lightweight learning state to /home/shiyi/Apps/Obsidian/vault/60-Wiki/learning/project-mastery/.
  • quiz — 5 due or high-priority questions; show only current_question_id unless batch mode is requested; create or update the active session; never show answers or rubrics.
  • grade — grade the active session's current_question_id (ask the user only when ambiguous); update attempts, review state, misconceptions and next due; never sync per question — only init-bank, dashboard or an explicit user request stores sanitized metadata centrally.
  • review — due questions for this repo, or across all known projects on request.
  • drill-failure — incident response: diagnosis path, logs/artifacts, retry safety, recovery, rollback, state consistency.
  • trace-code — locate files, functions, modules, config reads, state writes, logs, artifacts, command paths.
  • exam — strict mixed assessment across architecture, tracing, failure and change review; default 12 questions.
  • dashboard — Markdown and JSON only; no web UI.

Storage

Project-local files live under docs/ai/learning/. Central learning files live under:

text
/home/shiyi/Apps/Obsidian/vault/60-Wiki/learning/project-mastery/

Use UTC ISO-8601 timestamps with Z suffix internally. Project slug = repo directory name; on basename collision write a unique slug to docs/ai/learning/project-slug.txt(helper prefers it; a central-page collision aborts pointing here).

The helper script provides deterministic state operations:

text
python /home/shiyi/.codex/skills/project-mastery-coach/scripts/project_mastery_state.py validate --repo-root <path> --central-root <path>
python /home/shiyi/.codex/skills/project-mastery-coach/scripts/project_mastery_state.py select --repo-root <path> --mode quiz --count 5
python /home/shiyi/.codex/skills/project-mastery-coach/scripts/project_mastery_state.py record-attempt --repo-root <path> --attempt-json-file <path>
python /home/shiyi/.codex/skills/project-mastery-coach/scripts/project_mastery_state.py record-attempt --repo-root <path> --stdin
python /home/shiyi/.codex/skills/project-mastery-coach/scripts/project_mastery_state.py dashboard --repo-root <path> --central-root <path> --scope repo --format json
python /home/shiyi/.codex/skills/project-mastery-coach/scripts/project_mastery_state.py sync-central --repo-root <path> --central-root <path>

sync-central 非零退出分两段。stderr 里出现且只出现一条独立标签行,按整行精确匹配搜索它,不要只读开头几行——lint_wiki.sh 自身的 stderr 会先被转发,标签位置不固定:

  • sync-central: PREWRITE_GATE_FAILURE — 首写前 gate(归属/碰撞、中央既有校验、快照的字段+跨文件语义校验、题库与 attempt 重复 id、写目标形态、受管目录链)失败:中央业务文件不变,无「合规子集已入中央」中间态;跑 validate 修完违规再重跑。
  • sync-central: POSTWRITE_OR_LINT_FAILURE — 中央写入/原子替换/后置 lint_wiki.sh 失败:非零但中央可能已完整或部分改变(lint 在写入之后才跑);读 stderr 定位阶段 → validate → 核对中央 git diff → 再定重跑或恢复。

前者以「无带外替换」为前提:守卫只保证命令开始时观察到的受管目录链形态。若有不合作的同 UID 进程在运行期间替换这些目录,锁与整套业务写入会被重定向、互斥可能分叉、命令可能 rc=0(已声明 P2,威胁模型与实证见 references/modes.md)。

Central Wiki Rules

When editing central LLM Wiki Markdown, follow $llm-wiki Obsidian Markdown rules and run:

bash
/home/shiyi/Apps/Obsidian/vault/70-System/scripts/lint_wiki.sh

Reindex only when new/changed Markdown should become searchable:

bash
/home/shiyi/Apps/Obsidian/vault/70-System/scripts/reindex_qmd.sh llm-wiki

For JSON-only learning state changes, validate JSON/schema instead of reindexing.

Example Prompts

text
Use $project-mastery-coach init-bank for this repo.
Use $project-mastery-coach quiz this repo with 5 due questions.

© tudoumashu, MIT. 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 10 other files (scripts, references) in skills/project-mastery-coach of tudoumashu/ai-memory-skillpack.

  • SKILL.md
  • agents/openai.yaml
  • references/grading-and-spacing.md
  • references/modes.md
  • references/question-bank-guidelines.md
  • references/schemas.md
  • references/templates.md
  • schemas/attempt-record.schema.json
  • schemas/question-record.schema.json
  • schemas/review-state.schema.json
  • scripts/project_mastery_state.py

Open the folder on GitHubat commit f85cdec

Compare with similar skills

Project Mastery Coach 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.

Project Mastery Coach compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Mastery Coach this skilltudoumashu/ai-memory-skillpack456—~1.8kAutomated safety check: PassMIT
StudyVault Quiz Tutorbevibing/tutor-skills1.3k—~1.4kAutomated safety check: PassMIT
Claude Certification Tutorrohitg00/ai-engineering-from-scratch67k—~3kAutomated safety check: PassMIT
KaogongKeWang0622/kaogong-skill167—~1.2kAutomated safety check: PassMIT
Nlm Skilliusztinpaul/ai-research-os-workshop1791 repos~6.9kAutomated safety check: PassMIT
NotebookLM CLI Guidejacob-bd/notebooklm-cli256—~3.4kAutomated safety check: WarnMIT

Similar skills

  • 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
  • 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.

    67k GitHub stars~3k tokensUpdated today
    EducationAuto-check passed
  • Kaogong

    KeWang0622/kaogong-skill

    考公AI导师 — a tutor for the Chinese civil service exam (公务员考试), covering 行测 (aptitude), 申论 (essay), and 面试 (structured interview).

    167 GitHub stars~1.2k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Nlm Skill

    iusztinpaul/ai-research-os-workshop

    Expert guide for the NotebookLM CLI (nlm) and MCP server - interfaces for Google NotebookLM.

    179 GitHub starsUsed in 1 repo~6.9k tokens
    Knowledge ManagementAuto-check passed
  • NotebookLM CLI Guide

    jacob-bd/notebooklm-cli

    Guides use of the nlm command-line tool to automate Google NotebookLM: notebooks, sources, research, one-shot questions and generated podcasts, reports, quizzes and slides.

    256 GitHub stars~3.4k tokensUpdated 4 mo ago
    Knowledge ManagementAuto-check: warnings
  • Ccar F Examprep Coach

    sarveshtalele/claude-architect-exam-guide

    A personalized study-coach skill for the Claude Certified Architect – Foundations (CCAR-F) certification.

    175 GitHub stars~5.8k tokensUpdated 28 days ago
    EducationAuto-check passed

More from tudoumashu/ai-memory-skillpack

  • AI Project Memory

    tudoumashu/ai-memory-skillpack

    Maintain bounded, durable AI project memory in a repository's docs/ai/ pack.

    456 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • LLM Wiki

    tudoumashu/ai-memory-skillpack

    Query and maintain the user's local LLM Wiki from any Codex or Claude Code conversation or project.

    456 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Project Mastery Coach

What does Project Mastery Coach do?

Train strict project ownership from repo-local docs/ai memory and central LLM Wiki project entities. Project Mastery Coach is an agent skill from tudoumashu/ai-memory-skillpack. Train strict project ownership from repo-local docs/ai memory and central LLM Wiki project entities.

When should I use Project Mastery Coach?

Project Mastery Coach fits situations like: Claude Code should initialize a learning question bank; run code tracing; record misconceptions; schedule spaced repetition.

How do I install Project Mastery Coach in Claude Code?

Run `npx skills add tudoumashu/ai-memory-skillpack --skill project-mastery-coach -a claude-code`. Or copy the skill folder (skills/project-mastery-coach in tudoumashu/ai-memory-skillpack) into .claude/skills/project-mastery-coach in your project. Claude Code loads it when a task matches its description.

How do I install Project Mastery Coach in Codex?

Run `npx skills add tudoumashu/ai-memory-skillpack --skill project-mastery-coach -a codex`. Or copy the skill folder (skills/project-mastery-coach in tudoumashu/ai-memory-skillpack) into .agents/skills/project-mastery-coach in your project. Codex loads it when a task matches its description.

Can I use Project Mastery Coach 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 tudoumashu/ai-memory-skillpack --skill project-mastery-coach -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-mastery-coach, .gemini/skills/project-mastery-coach, .github/skills/project-mastery-coach and .opencode/skills/project-mastery-coach in your project.

What does Project Mastery Coach need to run?

Going by SKILL.md and its folder, Project Mastery Coach needs Python for the scripts in its folder and the command-line tools its instructions call (git). Our summary lists: Python 3.

Does Project Mastery Coach access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Project Mastery Coach 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 Project Mastery Coach use?

Project Mastery Coach is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Mastery Coach use?

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

What are the alternatives to Project Mastery Coach?

Skills that share tags, products or a category with Project Mastery Coach: StudyVault Quiz Tutor (bevibing/tutor-skills, 1.3k stars), Claude Certification Tutor (rohitg00/ai-engineering-from-scratch, 67k stars), Kaogong (KeWang0622/kaogong-skill, 167 stars) and Nlm Skill (iusztinpaul/ai-research-os-workshop, 179 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Mastery Coach?

tudoumashu (a GitHub user) maintains it in tudoumashu/ai-memory-skillpack, which has 456 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 8, 2026.

Source: tudoumashu/ai-memory-skillpack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.