trending/ai-engineering-from-scratch
1
0
Fork 0
mirror of https://github.com/rohitg00/ai-engineering-from-scratch.git synced 2026-10-02 01:54:39 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix(mcp): use required lesson header comments

Browse Source
This commit is contained in:
Rohit Ghumare
2026-08-23 16:16:12 +01:00
parent 967e6d0fc3
commit 177d81466b
28 changed files with 62 additions and 63 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude/skills/learn-agent-skills/SKILL.md
+1 -1
View File
@@ -21,7 +21,7 @@ syntax as universal.
| Host | Start or resume |
|---|---|
| Codex | `$learn-agent-skills`, or choose `learn-agent-skills` from `/skills` |
| Codex | `learn-agent-skills`, or choose it from `/skills` |
| Claude Code | `/learn-agent-skills` |
| Other compatible hosts | `Use learn-agent-skills to start or resume the Agent Skills Engineering path.` |
.claude/skills/learn-mcp-engineering/SKILL.md
+1 -1
View File
@@ -21,7 +21,7 @@ syntax as a protocol rule.
| Host | Start or resume |
|---|---|
| Codex | `$learn-mcp-engineering`, or choose `learn-mcp-engineering` from `/skills` |
| Codex | `learn-mcp-engineering`, or choose it from `/skills` |
| Claude Code | `/learn-mcp-engineering` |
| Other compatible hosts | `Use learn-mcp-engineering to start or resume the MCP Engineering path.` |
.claude/skills/start-learning/SKILL.md
+2 -2
View File
@@ -49,7 +49,7 @@ If the learner explicitly wants MCP Engineering rather than the full course,
do not run placement and do not create `LEARNING.md`. Route to the portable
skill `learn-mcp-engineering`, whose source is
`learning-paths/mcp-engineering.json` and whose state file is
`MCP-ENGINEERING-LEARNING.md`. Use `$learn-mcp-engineering` in Codex,
`MCP-ENGINEERING-LEARNING.md`. Use `learn-mcp-engineering` in Codex,
`/learn-mcp-engineering` in Claude Code, or ask another compatible host to use
`learn-mcp-engineering`. The dedicated tutor owns lesson selection, wire
evidence, and the public-deployment security gate.
@@ -60,7 +60,7 @@ If the learner explicitly wants Agent Skills instead of the full course, or
`AGENT-SKILLS-LEARNING.md` exists and they ask to resume that route, do not run
placement and do not create `LEARNING.md`. Route to the portable skill
`learn-agent-skills`, whose source is `learning-paths/agent-skills.json` and
whose state file is `AGENT-SKILLS-LEARNING.md`. Use `$learn-agent-skills` in
whose state file is `AGENT-SKILLS-LEARNING.md`. Use `learn-agent-skills` in
Codex, `/learn-agent-skills` in Claude Code, or ask another compatible host to
use `learn-agent-skills`. The dedicated tutor owns lesson selection, real-host
evidence, and the poisoning knowledge preflight.
README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
certifications/claude/lessons/11-mcp-server-design-and-integration/code/main.py
+5 -6
View File
@@ -1,9 +1,8 @@
"""Certification lesson 11: stateless MCP server design simulator.
Lesson: certifications/claude/lessons/11-mcp-server-design-and-integration/docs/en.md
MCP: https://modelcontextprotocol.io/specification/2026-07-28
Also follows JSON-RPC 2.0, RFC 2104 HMAC, and RFC 4648 base64url.
Run: python3 main.py
"""
# Certification lesson 11: stateless MCP server design simulator.
# Lesson: certifications/claude/lessons/11-mcp-server-design-and-integration/docs/en.md
# MCP: https://modelcontextprotocol.io/specification/2026-07-28
# Also follows JSON-RPC 2.0, RFC 2104 HMAC, and RFC 4648 base64url.
# Run: python3 main.py
from __future__ import annotations
i18n/ar/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/de/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/es/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/fr/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/hi/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/it/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/ja/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/ko/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/pt/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/ru/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/tr/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
i18n/zh/README.md
+3 -3
View File
@@ -72,7 +72,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start MCP Engineering | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp-engineering`, or choose it from `/skills` | `$learn-agent-skills`, or choose it from `/skills` | `$check-understanding 13`, or choose it from `/skills` |
| Codex | `start-learning`, or choose it from `/skills` | `learn-mcp-engineering`, or choose it from `/skills` | `learn-agent-skills`, or choose it from `/skills` | `check-understanding 13`, or choose it from `/skills` |
| Claude Code | `/start-learning` | `/learn-mcp-engineering` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp-engineering to start the MCP Engineering path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -80,8 +80,8 @@ A ten-question placement quiz maps what you already know to a starting phase and
saves a personalized study plan to `LEARNING.md`. From there, `/learn` teaches
one lesson per session — concept, math, code, quiz — streaming lessons straight
from this repo, and the `course-guide` skill jumps you to the exact lesson that
covers anything you are stuck on. In Codex, invoke these skills with `$learn`
and `$course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
covers anything you are stuck on. In Codex, invoke these skills with `learn`
and `course-guide`; in Claude Code, use `/learn` and `/course-guide`; in other
compatible hosts, ask to use the skill by name.
Only want MCP Engineering? Use the MCP invocation for your host. It creates
learning-paths/agent-skills.json
+1 -1
View File
@@ -47,7 +47,7 @@
}
],
"invocation": {
"codex": "$learn-agent-skills, or choose learn-agent-skills from /skills",
"codex": "learn-agent-skills, or choose it from /skills",
"claudeCode": "/learn-agent-skills",
"portableFallback": "Use learn-agent-skills to start or resume the Agent Skills Engineering path."
},
learning-paths/mcp-engineering.json
+1 -1
View File
@@ -34,7 +34,7 @@
}
],
"invocation": {
"codex": "$learn-mcp-engineering, or choose learn-mcp-engineering from /skills",
"codex": "learn-mcp-engineering, or choose it from /skills",
"claudeCode": "/learn-mcp-engineering",
"portableFallback": "Use learn-mcp-engineering to start or resume the MCP Engineering path."
},
phases/13-tools-and-protocols/22-skills-and-agent-sdks/docs/en.md
+1 -1
View File
@@ -117,7 +117,7 @@ directory, use the syntax supported by that host:
| Host | Explicit invocation |
|---|---|
| Codex | `$skill-contract-reviewer`, or choose it from `/skills`, then provide the review request |
| Codex | `skill-contract-reviewer`, or choose it from `/skills`, then provide the review request |
| Claude Code | `/skill-contract-reviewer` followed by the review request |
| Portable fallback | `Use skill-contract-reviewer to review the target package.` |
phases/13-tools-and-protocols/25-skill-invocation-and-routing/docs/en.md
+2 -2
View File
@@ -90,10 +90,10 @@ An explicit invocation supplies identity directly:
or:
```text
$release-readiness check v2.4.0 without publishing
release-readiness check v2.4.0 without publishing
```
Current Codex interfaces document `/skills` for selection and `$skill-name` for explicit invocation. Claude Code documents `/skill-name` and host-specific argument expansion. The exact syntax, menu visibility, quoting rules, and variable expansion belong to the host.
Current Codex interfaces document `/skills` for selection and plain skill names in requests for explicit invocation. Claude Code documents `/skill-name` and host-specific argument expansion. The exact syntax, menu visibility, quoting rules, and variable expansion belong to the host.
An explicit request still passes policy. Naming a skill should not bypass missing permissions, workspace constraints, approval gates, or runtime isolation.
phases/13-tools-and-protocols/27-skill-evals-packaging-and-portability/docs/en.md
+1 -1
View File
@@ -537,7 +537,7 @@ Use the explicit syntax supported by the first host:
| Host | Explicit invocation |
|---|---|
| Codex | `$skill-release-gate`, or choose it from `/skills`, then provide the evaluation request |
| Codex | `skill-release-gate`, or choose it from `/skills`, then provide the evaluation request |
| Claude Code | `/skill-release-gate` followed by the evaluation request |
| Portable fallback | `Use skill-release-gate to evaluate the target bundle.` |
phases/13-tools-and-protocols/README.md
+2 -2
View File
@@ -30,7 +30,7 @@ Start with the invocation supported by your host:
| Host | Invocation |
|---|---|
| Codex | `$learn-mcp-engineering`, or choose `learn-mcp-engineering` from `/skills` |
| Codex | `learn-mcp-engineering`, or choose it from `/skills` |
| Claude Code | `/learn-mcp-engineering` |
| Other compatible hosts | `Use learn-mcp-engineering to start or resume the MCP Engineering path.` |
@@ -82,7 +82,7 @@ Start with the invocation supported by your host:
| Host | Invocation |
|---|---|
| Codex | `$learn-agent-skills`, or choose `learn-agent-skills` from `/skills` |
| Codex | `learn-agent-skills`, or choose it from `/skills` |
| Claude Code | `/learn-agent-skills` |
| Other compatible hosts | `Use learn-agent-skills to start or resume the Agent Skills Engineering path.` |
site/lesson.html
+1 -1
View File
@@ -4696,7 +4696,7 @@
html += '<div class="quiz-score" id="quizScore"><div class="quiz-score-number" id="quizScoreNum">0/' + questions.length + '</div><div class="quiz-score-label">Complete all questions to see your score</div></div>';
var phaseArgumentMatch = phase.match(/^(\d+)/);
var phaseArgument = phaseArgumentMatch ? phaseArgumentMatch[1] : phase || 'current phase';
html += '<div class="quiz-deeper">Want a deeper quiz? In Codex use <code>$check-understanding ' + escapeHtml(phaseArgument) + '</code> or choose it from <code>/skills</code>. In Claude Code use <code>/check-understanding ' + escapeHtml(phaseArgument) + '</code>. In another compatible host say: <code>Use check-understanding to quiz me on Phase ' + escapeHtml(phaseArgument) + '.</code></div>';
html += '<div class="quiz-deeper">Want a deeper quiz? In Codex use <code>check-understanding ' + escapeHtml(phaseArgument) + '</code> or choose it from <code>/skills</code>. In Claude Code use <code>/check-understanding ' + escapeHtml(phaseArgument) + '</code>. In another compatible host say: <code>Use check-understanding to quiz me on Phase ' + escapeHtml(phaseArgument) + '.</code></div>';
html += '</div>';
body.innerHTML = html;
site/test_build_artifacts.js
+1 -1
View File
@@ -875,7 +875,7 @@ test('lesson reader keeps learning-path context and renders a copyable full-dept
assert.match(lessonHtml, /git rev-parse --show-toplevel/);
assert.match(lessonHtml, /lessonQuizCorrectAnswers\[qid\] = q\.correct/);
assert.doesNotMatch(lessonHtml, /data-correct=/);
assert.match(lessonHtml, /\$check-understanding/);
assert.match(lessonHtml, /In Codex use <code>check-understanding /);
assert.match(lessonHtml, /\/check-understanding/);
});
skills/learn-agent-skills/SKILL.md
+1 -1
View File
@@ -21,7 +21,7 @@ syntax as universal.
| Host | Start or resume |
|---|---|
| Codex | `$learn-agent-skills`, or choose `learn-agent-skills` from `/skills` |
| Codex | `learn-agent-skills`, or choose it from `/skills` |
| Claude Code | `/learn-agent-skills` |
| Other compatible hosts | `Use learn-agent-skills to start or resume the Agent Skills Engineering path.` |
skills/learn-mcp-engineering/SKILL.md
+1 -1
View File
@@ -21,7 +21,7 @@ syntax as a protocol rule.
| Host | Start or resume |
|---|---|
| Codex | `$learn-mcp-engineering`, or choose `learn-mcp-engineering` from `/skills` |
| Codex | `learn-mcp-engineering`, or choose it from `/skills` |
| Claude Code | `/learn-mcp-engineering` |
| Other compatible hosts | `Use learn-mcp-engineering to start or resume the MCP Engineering path.` |
skills/start-learning/SKILL.md
+2 -2
View File
@@ -49,7 +49,7 @@ If the learner explicitly wants MCP Engineering rather than the full course,
do not run placement and do not create `LEARNING.md`. Route to the portable
skill `learn-mcp-engineering`, whose source is
`learning-paths/mcp-engineering.json` and whose state file is
`MCP-ENGINEERING-LEARNING.md`. Use `$learn-mcp-engineering` in Codex,
`MCP-ENGINEERING-LEARNING.md`. Use `learn-mcp-engineering` in Codex,
`/learn-mcp-engineering` in Claude Code, or ask another compatible host to use
`learn-mcp-engineering`. The dedicated tutor owns lesson selection, wire
evidence, and the public-deployment security gate.
@@ -60,7 +60,7 @@ If the learner explicitly wants Agent Skills instead of the full course, or
`AGENT-SKILLS-LEARNING.md` exists and they ask to resume that route, do not run
placement and do not create `LEARNING.md`. Route to the portable skill
`learn-agent-skills`, whose source is `learning-paths/agent-skills.json` and
whose state file is `AGENT-SKILLS-LEARNING.md`. Use `$learn-agent-skills` in
whose state file is `AGENT-SKILLS-LEARNING.md`. Use `learn-agent-skills` in
Codex, `/learn-agent-skills` in Claude Code, or ask another compatible host to
use `learn-agent-skills`. The dedicated tutor owns lesson selection, real-host
evidence, and the poisoning knowledge preflight.