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

Merge branch 'feat/agent-skills-course' into feat/course-site-learning-dx

Browse Source
This commit is contained in:
Rohit Ghumare
2026-08-23 16:24:03 +01:00
parent 9abd809bef 177d81466b
commit ce63280f25
32 changed files with 70 additions and 71 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude/skills/course-guide/SKILL.md
+1 -1
View File
@@ -23,7 +23,7 @@ lives and which command to run next. Works with any agent.
Skill names are portable, but invocation syntax belongs to the host. Render
every recommended next action in the correct form:
- Codex: `$learn`, `$start-learning`, `$course-guide`, and other `$skill-name`
- Codex: `learn`, `start-learning`, `course-guide`, and other `skill-name`
forms, or tell the learner to choose the skill from `/skills`.
- Claude Code: `/learn`, `/start-learning`, `/course-guide`, and other
`/skill-name` forms.
.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/SKILL.md
+1 -1
View File
@@ -21,7 +21,7 @@ syntax as a protocol rule.
| Host | Start or resume |
|---|---|
| Codex | `$learn-mcp`, or choose `learn-mcp` from `/skills` |
| Codex | `learn-mcp`, or choose it from `/skills` |
| Claude Code | `/learn-mcp` |
| Other compatible hosts | `Use learn-mcp to start or resume the Model Context Protocol (MCP) path.` |
.claude/skills/learn/SKILL.md
+2 -2
View File
@@ -22,8 +22,8 @@ answer, and run things — never just scroll. Works with any agent.
Skill names are portable, but invocation syntax belongs to the host. Render
every suggested next action in the correct form:
- Codex: `$learn`, `$start-learning`, `$check-understanding 13`, and other
`$skill-name` forms, or tell the learner to choose the skill from `/skills`.
- Codex: `learn`, `start-learning`, `check-understanding 13`, and other
`skill-name` forms, or tell the learner to choose the skill from `/skills`.
- Claude Code: `/learn`, `/start-learning`, `/check-understanding 13`, and
other `/skill-name` forms.
- Other compatible hosts: natural language such as `Use start-learning to
.claude/skills/start-learning/SKILL.md
+3 -3
View File
@@ -28,7 +28,7 @@ text and wait for the reply.
Skill names are portable, but invocation syntax belongs to the host. Before
showing a next command, use the correct form:
- Codex: `$start-learning`, `$learn`, `$course-guide`, and other `$skill-name`
- Codex: `start-learning`, `learn`, `course-guide`, and other `skill-name`
forms, or tell the learner to choose the skill from `/skills`.
- Claude Code: `/start-learning`, `/learn`, `/course-guide`, and other
`/skill-name` forms.
@@ -73,7 +73,7 @@ If the learner explicitly wants Model Context Protocol (MCP) rather than the
full course, do not run placement and do not create `LEARNING.md`. Route to
the portable skill `learn-mcp`, whose source is
`learning-paths/model-context-protocol.json` and whose state file is
`MCP-LEARNING.md`. Use `$learn-mcp` in Codex,
`MCP-LEARNING.md`. Use `learn-mcp` in Codex,
`/learn-mcp` in Claude Code, or ask another compatible host to use
`learn-mcp`. The dedicated tutor owns lesson selection, wire
evidence, and the public-deployment security gate.
@@ -84,7 +84,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 the five-lesson order,
real-host evidence, sandbox boundaries, the Lesson 25 and tool-poisoning
README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
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
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/de/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/es/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/fr/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/hi/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/it/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/ja/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/ko/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/pt/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/ru/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/tr/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
i18n/zh/README.md
+3 -3
View File
@@ -118,7 +118,7 @@ Invocation syntax belongs to the host, not to the portable `SKILL.md` format:
| Host | Start the course | Start Model Context Protocol (MCP) | Start Agent Skills | Run a phase quiz |
|---|---|---|---|---|
| Codex | `$start-learning`, or choose it from `/skills` | `$learn-mcp`, 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`, 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` | `/learn-agent-skills` | `/check-understanding 13` |
| Other compatible hosts | `Use start-learning to begin the course.` | `Use learn-mcp to start the Model Context Protocol (MCP) path.` | `Use learn-agent-skills to start the Agent Skills Engineering path.` | `Use check-understanding to quiz me on Phase 13.` |
@@ -127,7 +127,7 @@ saves a personalized study plan to `LEARNING.md`. From there, the `learn` skill
teaches one lesson per session: concept, math, code, quiz. It streams 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`;
`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 Model Context Protocol (MCP)? Use the MCP invocation for your host. It creates
@@ -281,7 +281,7 @@ diagnostic, capstone work, and a full-length original practice exam.
Use the [AI-native GitHub onboarding guide](../../certifications/claude/GETTING_STARTED.md)
with Claude Code, Codex, ChatGPT, Cursor, or another agent. Run
`$claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
`claude-certification` in Codex, `/claude-certification` in Claude Code, or ask
another host to use `claude-certification`. It chooses a track, creates a
persistent route in `CLAUDE-CERTIFICATION.md`, teaches one step at a time, runs
the real labs, and gives artifact-based feedback. The same curriculum remains
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/model-context-protocol.json
+1 -1
View File
@@ -34,7 +34,7 @@
}
],
"invocation": {
"codex": "$learn-mcp, or choose learn-mcp from /skills",
"codex": "learn-mcp, or choose it from /skills",
"claudeCode": "/learn-mcp",
"portableFallback": "Use learn-mcp to start or resume the Model Context Protocol (MCP) 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
@@ -81,10 +81,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
@@ -505,7 +505,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
@@ -52,7 +52,7 @@ Start with the invocation supported by your host:
| Host | Invocation |
|---|---|
| Codex | `$learn-mcp`, or choose `learn-mcp` from `/skills` |
| Codex | `learn-mcp`, or choose it from `/skills` |
| Claude Code | `/learn-mcp` |
| Other compatible hosts | `Use learn-mcp to start or resume the Model Context Protocol (MCP) path.` |
@@ -104,7 +104,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
@@ -5396,7 +5396,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
@@ -1266,7 +1266,7 @@ test('lesson reader keeps learning-path context and renders a copyable full-dept
assert.doesNotMatch(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/);
assert.match(lessonHtml, /Act on this lesson/);
assert.match(lessonHtml, /data-checkpoint="read"/);
skills/course-guide/SKILL.md
+1 -1
View File
@@ -23,7 +23,7 @@ lives and which command to run next. Works with any agent.
Skill names are portable, but invocation syntax belongs to the host. Render
every recommended next action in the correct form:
- Codex: `$learn`, `$start-learning`, `$course-guide`, and other `$skill-name`
- Codex: `learn`, `start-learning`, `course-guide`, and other `skill-name`
forms, or tell the learner to choose the skill from `/skills`.
- Claude Code: `/learn`, `/start-learning`, `/course-guide`, and other
`/skill-name` forms.
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/SKILL.md
+1 -1
View File
@@ -21,7 +21,7 @@ syntax as a protocol rule.
| Host | Start or resume |
|---|---|
| Codex | `$learn-mcp`, or choose `learn-mcp` from `/skills` |
| Codex | `learn-mcp`, or choose it from `/skills` |
| Claude Code | `/learn-mcp` |
| Other compatible hosts | `Use learn-mcp to start or resume the Model Context Protocol (MCP) path.` |
skills/learn/SKILL.md
+2 -2
View File
@@ -22,8 +22,8 @@ answer, and run things — never just scroll. Works with any agent.
Skill names are portable, but invocation syntax belongs to the host. Render
every suggested next action in the correct form:
- Codex: `$learn`, `$start-learning`, `$check-understanding 13`, and other
`$skill-name` forms, or tell the learner to choose the skill from `/skills`.
- Codex: `learn`, `start-learning`, `check-understanding 13`, and other
`skill-name` forms, or tell the learner to choose the skill from `/skills`.
- Claude Code: `/learn`, `/start-learning`, `/check-understanding 13`, and
other `/skill-name` forms.
- Other compatible hosts: natural language such as `Use start-learning to
skills/start-learning/SKILL.md
+3 -3
View File
@@ -28,7 +28,7 @@ text and wait for the reply.
Skill names are portable, but invocation syntax belongs to the host. Before
showing a next command, use the correct form:
- Codex: `$start-learning`, `$learn`, `$course-guide`, and other `$skill-name`
- Codex: `start-learning`, `learn`, `course-guide`, and other `skill-name`
forms, or tell the learner to choose the skill from `/skills`.
- Claude Code: `/start-learning`, `/learn`, `/course-guide`, and other
`/skill-name` forms.
@@ -73,7 +73,7 @@ If the learner explicitly wants Model Context Protocol (MCP) rather than the
full course, do not run placement and do not create `LEARNING.md`. Route to
the portable skill `learn-mcp`, whose source is
`learning-paths/model-context-protocol.json` and whose state file is
`MCP-LEARNING.md`. Use `$learn-mcp` in Codex,
`MCP-LEARNING.md`. Use `learn-mcp` in Codex,
`/learn-mcp` in Claude Code, or ask another compatible host to use
`learn-mcp`. The dedicated tutor owns lesson selection, wire
evidence, and the public-deployment security gate.
@@ -84,7 +84,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 the five-lesson order,
real-host evidence, sandbox boundaries, the Lesson 25 and tool-poisoning