From 177d81466b89ac1963671bbd9aa5d4f49139db29 Mon Sep 17 00:00:00 2001 From: Rohit Ghumare Date: Sun, 23 Aug 2026 16:01:49 +0100 Subject: [PATCH] fix(mcp): use required lesson header comments --- .claude/skills/learn-agent-skills/SKILL.md | 2 +- .claude/skills/learn-mcp-engineering/SKILL.md | 2 +- .claude/skills/start-learning/SKILL.md | 4 ++-- README.md | 6 +++--- .../11-mcp-server-design-and-integration/code/main.py | 11 +++++------ i18n/ar/README.md | 6 +++--- i18n/de/README.md | 6 +++--- i18n/es/README.md | 6 +++--- i18n/fr/README.md | 6 +++--- i18n/hi/README.md | 6 +++--- i18n/it/README.md | 6 +++--- i18n/ja/README.md | 6 +++--- i18n/ko/README.md | 6 +++--- i18n/pt/README.md | 6 +++--- i18n/ru/README.md | 6 +++--- i18n/tr/README.md | 6 +++--- i18n/zh/README.md | 6 +++--- learning-paths/agent-skills.json | 2 +- learning-paths/mcp-engineering.json | 2 +- .../22-skills-and-agent-sdks/docs/en.md | 2 +- .../25-skill-invocation-and-routing/docs/en.md | 4 ++-- .../docs/en.md | 2 +- phases/13-tools-and-protocols/README.md | 4 ++-- site/lesson.html | 2 +- site/test_build_artifacts.js | 2 +- skills/learn-agent-skills/SKILL.md | 2 +- skills/learn-mcp-engineering/SKILL.md | 2 +- skills/start-learning/SKILL.md | 4 ++-- 28 files changed, 62 insertions(+), 63 deletions(-) diff --git a/.claude/skills/learn-agent-skills/SKILL.md b/.claude/skills/learn-agent-skills/SKILL.md index 46a5d9d5d..c72035169 100644 --- a/.claude/skills/learn-agent-skills/SKILL.md +++ b/.claude/skills/learn-agent-skills/SKILL.md @@ -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.` | diff --git a/.claude/skills/learn-mcp-engineering/SKILL.md b/.claude/skills/learn-mcp-engineering/SKILL.md index 57039df10..2502949d6 100644 --- a/.claude/skills/learn-mcp-engineering/SKILL.md +++ b/.claude/skills/learn-mcp-engineering/SKILL.md @@ -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.` | diff --git a/.claude/skills/start-learning/SKILL.md b/.claude/skills/start-learning/SKILL.md index a6e184b4f..cecad224a 100644 --- a/.claude/skills/start-learning/SKILL.md +++ b/.claude/skills/start-learning/SKILL.md @@ -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. diff --git a/README.md b/README.md index 693d7faaa..3d77f6e90 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/certifications/claude/lessons/11-mcp-server-design-and-integration/code/main.py b/certifications/claude/lessons/11-mcp-server-design-and-integration/code/main.py index 9854fe520..b0c502738 100644 --- a/certifications/claude/lessons/11-mcp-server-design-and-integration/code/main.py +++ b/certifications/claude/lessons/11-mcp-server-design-and-integration/code/main.py @@ -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 diff --git a/i18n/ar/README.md b/i18n/ar/README.md index 561750f8c..07ca2722d 100644 --- a/i18n/ar/README.md +++ b/i18n/ar/README.md @@ -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 diff --git a/i18n/de/README.md b/i18n/de/README.md index b43da6f8a..4cb6b821b 100644 --- a/i18n/de/README.md +++ b/i18n/de/README.md @@ -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 diff --git a/i18n/es/README.md b/i18n/es/README.md index 253f05f62..d790bc8b0 100644 --- a/i18n/es/README.md +++ b/i18n/es/README.md @@ -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 diff --git a/i18n/fr/README.md b/i18n/fr/README.md index 8af856265..8109d4104 100644 --- a/i18n/fr/README.md +++ b/i18n/fr/README.md @@ -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 diff --git a/i18n/hi/README.md b/i18n/hi/README.md index 146118658..f29eab09f 100644 --- a/i18n/hi/README.md +++ b/i18n/hi/README.md @@ -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 diff --git a/i18n/it/README.md b/i18n/it/README.md index 58cc7b11d..7000bcd3d 100644 --- a/i18n/it/README.md +++ b/i18n/it/README.md @@ -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 diff --git a/i18n/ja/README.md b/i18n/ja/README.md index d485d4140..b339a433d 100644 --- a/i18n/ja/README.md +++ b/i18n/ja/README.md @@ -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 diff --git a/i18n/ko/README.md b/i18n/ko/README.md index a6694d4fe..2ad6b9710 100644 --- a/i18n/ko/README.md +++ b/i18n/ko/README.md @@ -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 diff --git a/i18n/pt/README.md b/i18n/pt/README.md index 140d75d41..91805da33 100644 --- a/i18n/pt/README.md +++ b/i18n/pt/README.md @@ -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 diff --git a/i18n/ru/README.md b/i18n/ru/README.md index dbde4d422..d6bdbb941 100644 --- a/i18n/ru/README.md +++ b/i18n/ru/README.md @@ -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 diff --git a/i18n/tr/README.md b/i18n/tr/README.md index bb95b53e1..568836296 100644 --- a/i18n/tr/README.md +++ b/i18n/tr/README.md @@ -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 diff --git a/i18n/zh/README.md b/i18n/zh/README.md index bdd08f2f5..4ba27ae1b 100644 --- a/i18n/zh/README.md +++ b/i18n/zh/README.md @@ -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 diff --git a/learning-paths/agent-skills.json b/learning-paths/agent-skills.json index 210ba0b97..c2364352f 100644 --- a/learning-paths/agent-skills.json +++ b/learning-paths/agent-skills.json @@ -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." }, diff --git a/learning-paths/mcp-engineering.json b/learning-paths/mcp-engineering.json index 4ea2f297d..e067a4482 100644 --- a/learning-paths/mcp-engineering.json +++ b/learning-paths/mcp-engineering.json @@ -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." }, diff --git a/phases/13-tools-and-protocols/22-skills-and-agent-sdks/docs/en.md b/phases/13-tools-and-protocols/22-skills-and-agent-sdks/docs/en.md index 69b2fcb27..e271b9ed6 100644 --- a/phases/13-tools-and-protocols/22-skills-and-agent-sdks/docs/en.md +++ b/phases/13-tools-and-protocols/22-skills-and-agent-sdks/docs/en.md @@ -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.` | diff --git a/phases/13-tools-and-protocols/25-skill-invocation-and-routing/docs/en.md b/phases/13-tools-and-protocols/25-skill-invocation-and-routing/docs/en.md index 789a164f9..a631eef1f 100644 --- a/phases/13-tools-and-protocols/25-skill-invocation-and-routing/docs/en.md +++ b/phases/13-tools-and-protocols/25-skill-invocation-and-routing/docs/en.md @@ -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. diff --git a/phases/13-tools-and-protocols/27-skill-evals-packaging-and-portability/docs/en.md b/phases/13-tools-and-protocols/27-skill-evals-packaging-and-portability/docs/en.md index 72808562e..ec7d592a8 100644 --- a/phases/13-tools-and-protocols/27-skill-evals-packaging-and-portability/docs/en.md +++ b/phases/13-tools-and-protocols/27-skill-evals-packaging-and-portability/docs/en.md @@ -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.` | diff --git a/phases/13-tools-and-protocols/README.md b/phases/13-tools-and-protocols/README.md index 8c5f60cd4..d5222d28f 100644 --- a/phases/13-tools-and-protocols/README.md +++ b/phases/13-tools-and-protocols/README.md @@ -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.` | diff --git a/site/lesson.html b/site/lesson.html index 3896f7cff..e5f57628a 100644 --- a/site/lesson.html +++ b/site/lesson.html @@ -4696,7 +4696,7 @@ html += '
0/' + questions.length + '
Complete all questions to see your score
'; var phaseArgumentMatch = phase.match(/^(\d+)/); var phaseArgument = phaseArgumentMatch ? phaseArgumentMatch[1] : phase || 'current phase'; - html += '
Want a deeper quiz? In Codex use $check-understanding ' + escapeHtml(phaseArgument) + ' or choose it from /skills. In Claude Code use /check-understanding ' + escapeHtml(phaseArgument) + '. In another compatible host say: Use check-understanding to quiz me on Phase ' + escapeHtml(phaseArgument) + '.
'; + html += '
Want a deeper quiz? In Codex use check-understanding ' + escapeHtml(phaseArgument) + ' or choose it from /skills. In Claude Code use /check-understanding ' + escapeHtml(phaseArgument) + '. In another compatible host say: Use check-understanding to quiz me on Phase ' + escapeHtml(phaseArgument) + '.
'; html += ''; body.innerHTML = html; diff --git a/site/test_build_artifacts.js b/site/test_build_artifacts.js index 323e76405..3b5193f43 100644 --- a/site/test_build_artifacts.js +++ b/site/test_build_artifacts.js @@ -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 check-understanding /); assert.match(lessonHtml, /\/check-understanding/); }); diff --git a/skills/learn-agent-skills/SKILL.md b/skills/learn-agent-skills/SKILL.md index 46a5d9d5d..c72035169 100644 --- a/skills/learn-agent-skills/SKILL.md +++ b/skills/learn-agent-skills/SKILL.md @@ -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.` | diff --git a/skills/learn-mcp-engineering/SKILL.md b/skills/learn-mcp-engineering/SKILL.md index 57039df10..2502949d6 100644 --- a/skills/learn-mcp-engineering/SKILL.md +++ b/skills/learn-mcp-engineering/SKILL.md @@ -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.` | diff --git a/skills/start-learning/SKILL.md b/skills/start-learning/SKILL.md index a6e184b4f..cecad224a 100644 --- a/skills/start-learning/SKILL.md +++ b/skills/start-learning/SKILL.md @@ -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.