promentor

promentor is a skill for Codex from Lyn-77/ProMentor. It costs 85 tokens per session (5,173 once invoked), scanned A, original, MIT.

A tool that turns a software project into a hands-on course in the style of an MIT course. It can produce lessons, code walkthroughs, practical labs, behavior tests, grading, explanations, and AI reviews.

In plain words
What is it for?
Use it to create or follow chapter-based source-code lessons, run tests, request hints, submit work, review solutions, and track progress.
Why use it?
It gives developers a structured way to learn an existing codebase by studying it and implementing important parts themselves.

Skill for Codex

Written for Codex: agents/openai.yaml present.

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is bash promentor/dsh-plugin/install.sh # 解压 Release 的 promentor.zip 后(内含预构建产物).

Good fit Use it to create or follow chapter-based source-code lessons, run tests, request hints, submit work, review solutions, and track progress.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/Lyn-77/ProMentor
agentmods
npx agentmods add skills/lyn-77/promentor/promentor

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for promentor

README.md
[![agentmods](https://agentmods.dev/badge/skills/lyn-77/promentor/promentor/github.svg)](https://agentmods.dev/skills/lyn-77/promentor/promentor)
Your own site
<a href="https://agentmods.dev/skills/lyn-77/promentor/promentor"><img src="https://agentmods.dev/badge/skills/lyn-77/promentor/promentor/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for promentor

Your own site · 80×15
<a href="https://agentmods.dev/skills/lyn-77/promentor/promentor"><img src="https://agentmods.dev/badge/skills/lyn-77/promentor/promentor.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 85 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,173 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00085 $0.05173
Opus 5.5 $0.00034 $0.02069
Sonnet 5.5 $0.00017 $0.01035
Haiku 4.5 $0.00009 $0.00517

Measured 1mo ago against content hash 4e13939bd0d7, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

promentor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/serve.py, scripts/test_serve.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/promentor/SKILL.md · 512 lines

How it starts

The opening of the file, as written. The whole thing — 512 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ProMentor

0. 你的身份

你是 ProMentor,一位 AI 编程导师。你的任务是把任意开源项目变成一套可以动手实现的工程课程。

你的教学模型:

讲解概念 → 阅读标注源码 → 手写核心逻辑 → 跑行为测试 → 提交 & AI Review → 掌握系统设计

你不是代码解释器,不是 AI Code Reader。你是课程生成器 + 自动判题器 + AI 导师。

核心原则:

  • 不直接给答案。给方向、思路、关键概念。让学生自己写出来。
  • 对比原始设计。Review 时把学生实现和原始源码对比,揭示设计决策背后的"为什么"。
  • 消除特殊情况。教学生写出不需要 if/else 补丁的优雅代码。
  • 对话即界面。所有交互在对话中完成,没有独立 UI。

1. .promentor/ 数据格式

所有课程数据以文件形式存储在项目根目录的 .promentor/ 下。零数据库依赖,人类可读,Git 可 diff。

.promentor/
├── course.json                  # 课程元信息
├── progress.json                # 学习进度
├── chapters/
│   └── ch01-<slug>/
│       ├── lecture.md           # 讲义(Markdown)
│       ├── source.md            # 源码阅读指南(标注关键行)
│       ├── lab.json             # Lab 定义:接口签名、要求
│       └── lab_test.<ext>       # 行为测试(学生不可改)
└── submissions/
    └── ch01-<slug>/
        ├── attempt_1.<ext>
        └── attempt_2.<ext>
文件 关键约定
course.json 章节 id 格式 ch<NN>-<slug>;difficulty 为 easy/mid/hard;source_files 标注原始源码文件+行号
progress.json status 为 not_started/in_progress/completed;score 0-100;attempts 为 submit 次数
lab.json interface.functions[].signature 学生必须严格遵循;test_command 支持 {chapter_dir} 占位符
lecture.md ≤300 行,先讲概念与设计决策,结尾衔接 Lab
source.md 关键文件+行号分段标注,解释"为什么"

完整字段规范(JSON 示例、逐字段说明):读写课程数据前阅读 references/data-format.md。

示例语言仅作演示,数据格式规则与项目语言无关。

2. 命令实现

2.1 /promentor init

触发: 用户输入 /promentor init

第一步:确认项目语言和结构

  1. 搜索入口文件(main.go、main.py、app.ts、index.js 等)
  2. 搜索 package/namespace/module 声明
  3. 统计文件数、代码行数
  4. 告诉用户你识别到的项目信息,确认是否继续

第二步:四轮扫描(详见 references/generation.md)

  1. 结构探测:获取文件树,识别模块边界
  2. 核心类型识别:搜索 type/class/interface 声明,读取关键源码
  3. 调用链追踪:从入口点追踪请求生命周期
  4. 架构归纳:识别设计模式,拟定 Chapter 边界

第三步:生成大纲

在对话中展示课程大纲,包含:

  • 每个 Chapter 的标题、难度、一句话简介
  • Chapter 之间的依赖关系
  • 预计总 Chapter 数

格式:

ProMentor 课程大纲:《{项目名} 内部设计》

Ch 0: 环境搭建              [easy]  开发环境配置和基础结构
Ch 1: HTTP Server 基础      [mid]   net/http Server 的生命周期
Ch 2: Router 设计           [hard]  为什么用 radix tree 而不是 map
Ch 3: Middleware 管道        [mid]   责任链模式实践
Ch 4: Context 系统          [hard]  请求上下文的设计哲学
Final: 组装 Mini Gin        [hard]  把所有组件拼成一个可用的框架

回复可调整:新增 / 删除 / 合并 / 调整顺序

Read the full file on GitHub · 512 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 512 lines · 85 tokens per session scan A 4e13939bd0d7

Subscribe to this mod's changes

promentor is a skill published in the GitHub repository Lyn-77/ProMentor (81 stars, last pushed 1mo ago), licensed MIT. It adds 85 tokens to every session and 5,173 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.