Loopath

A bilingual interactive skill for learning loop engineering inside an agent.

Loopath is a small reference course for understanding the harness around coding agents: context building, structured actions, policy-gated tools, observations, traces, verification, and evals.

It is meant to be installed as an agent skill. After installation, the agent guides you one step at a time. Each step includes a short text card and a matching clip under media/episode-01/clips/.

Getting Started

Install the skill:

git clone https://github.com/encircleacity2/loopath ~/.codex/skills/loopath

For Claude Code:

git clone https://github.com/encircleacity2/loopath ~/.claude/skills/loopath

Restart your agent session, then say:

Use $loopath to start the Loopath course.

The skill will detect your conversation language, show one small topic at a time, and include the matching step clip path:

media/episode-01/clips/en/step-01.mp4
media/episode-01/clips/zh/step-01.mp4

What You Should See

Learning Flow

1. Start with $loopath.
2. Read the current step card.
3. Watch the matching clip.
4. Ask questions or continue to the next step.
5. Let the agent create the lab files.
6. Run verification and inspect the result card.
7. Answer quiz questions one at a time.

Course Materials

• Full course draft
• English teaching notes
• Chinese teaching notes
• Episode 1 English clips
• Episode 1 Chinese clips
• Lab verifier

Optional local commands for maintainers

Start the course:

python3 scripts/loopath.py start --lang en

Show a step:

python3 scripts/loopath.py step --episode 1 --step 1 --lang en

Create the lab:

python3 scripts/loopath.py lab-create --episode 1 --repo ./loopath-dev --lang en

Run verification:

python3 scripts/loopath.py verify --episode 1 --repo ./loopath-dev --lang en

Ask and grade a quiz question:

python3 scripts/loopath.py quiz --episode 1 --question 1 --lang en
python3 scripts/loopath.py grade --episode 1 --question 1 --answer "B" --lang en

Current Scope

The interactive skill currently implements Episode 1 end to end: step cards, bilingual clips, lab creation, verification, and quiz grading.

License

MIT.

---

Loopath 中文说明

一个在 agent 里学习 loop engineering 的中英双语互动 skill。

Loopath 是一套小型参考课程，用来理解 coding agent 背后的 harness：context 构建、结构化 action、policy-gated tools、observation、trace、verification 和 eval。

它的定位是可安装到 agent 里的学习 skill。安装后，agent 会一次带你学习一个小课题。每个 step 都有文字卡片，也有对应的短 clip，路径在 media/episode-01/clips/。

Getting Started / 快速开始

安装到 Codex：

git clone https://github.com/encircleacity2/loopath ~/.codex/skills/loopath

安装到 Claude Code：

git clone https://github.com/encircleacity2/loopath ~/.claude/skills/loopath

重启 agent session，然后输入：

Use $loopath to start the Loopath course.

skill 会根据你的对话语言选择中文或英文，每次展示一个小课题，并返回对应 step clip：

media/episode-01/clips/zh/step-01.mp4
media/episode-01/clips/en/step-01.mp4

Agent 中的参考截图

学习流程

1. 用 $loopath 启动课程。
2. 阅读当前 step 卡片。
3. 观看对应 clip。
4. 提问，或者继续下一步。
5. 让 agent 创建 lab 文件。
6. 运行 verification，查看检测结果卡片。
7. 一问一答完成 quiz。

课程材料

• 完整课程草稿
• 英文教学参考
• 中文教学参考
• Episode 1 英文 clips
• Episode 1 中文 clips
• Lab 验收脚本

维护者可选本地命令

启动课程：

python3 scripts/loopath.py start --lang zh

展示一个 step：

python3 scripts/loopath.py step --episode 1 --step 1 --lang zh

创建 lab：

python3 scripts/loopath.py lab-create --episode 1 --repo ./loopath-dev --lang zh

运行验收：

python3 scripts/loopath.py verify --episode 1 --repo ./loopath-dev --lang zh

提问并评分：

python3 scripts/loopath.py quiz --episode 1 --question 1 --lang zh
python3 scripts/loopath.py grade --episode 1 --question 1 --answer "B" --lang zh

当前范围

互动 skill 目前完整实现 Episode 1：step 卡片、双语 clips、lab 创建、verification 和 quiz 评分。