/install duolingo
Setup
On first use, read setup.md for routing, filesystem bootstrap, and topic activation.
When to Use
User wants to learn one or more subjects with short daily lessons, instant feedback, streak pressure, and ongoing review. Agent runs a Duolingo-style operating system (not just advice) with topic folders, per-topic curriculum, cross-topic planning, and optional AGENTS router integration.
Architecture
State lives in ~/duolingo/. See memory-template.md for global state and per-topic file templates.
~/duolingo/
|-- memory.md # Global status and active topic map
|-- router/
| |-- topics.md # Canonical list of active topics and trigger phrases
| `-- agentsmd-snippet.md # Snippet to keep AGENTS routing in sync
|-- topics/
| |-- english/
| | |-- profile.md # Goal, level, pace, constraints
| | |-- curriculum.md # Skill tree and lesson units
| | |-- queue.md # Next lessons and review backlog
| | |-- sessions.md # Session history and outcomes
| | `-- checkpoints.md # Weekly and milestone checks
| `-- cooking/ # Same structure for any other topic
`-- archive/ # Retired topics and old curriculum versions
Quick Reference
| Topic | File |
|---|---|
| Setup flow | setup.md |
| Global memory template | memory-template.md |
| Filesystem bootstrap | blueprint.md |
| AGENTS routing rules | activation-routing.md |
| Lesson runtime loop | lesson-loop.md |
| XP/hearts/streak economy | progression.md |
| Multi-topic retention ops | retention-ops.md |
| Topic namespace templates | topic-template.md |
| Weekly health review | launch-scorecard.md |
Core Rules
1. Bootstrap the Learning OS Before First Lesson
If ~/duolingo/ is missing or empty, create the full scaffold from blueprint.md.
Do not start teaching without:
- global memory file
- router files
- at least one topic namespace
2. Offer Optional AGENTS Router Integration
If the user wants automatic routing, provide the AGENTS router snippet from activation-routing.md.
Never auto-edit AGENTS from this skill. Generate snippet text only and let the user apply it.
If the user skips router integration, keep the skill fully manual and user-invocable.
3. Keep Each Topic Isolated, Then Coordinate Globally
Every topic gets its own namespace under ~/duolingo/topics/\x3Ctopic-slug>/.
Never mix files across topics.
Global planning may schedule multiple topics in one day, but lesson state stays per-topic.
4. Run Lessons as Tight Interactive Loops
Use lesson-loop.md for every session:
- micro-challenge
- learner attempt
- immediate correction
- reinforcement challenge
- queue update
One loop should finish in about 60-90 seconds.
5. Support Concurrent Tracks Without Context Loss
User can learn multiple topics at once (for example English and cooking). For each session, select one active topic, load only that namespace, then update global planner with:
- completion result
- next due lesson
- next review date
6. Use a Transparent Progression Economy
Apply XP, hearts, streaks, and mastery rules from progression.md.
Rewards must reflect demonstrated learning, not random activity.
When motivation drops, adjust pacing before adding gamification complexity.
7. Prioritize Retention and Review Over New Content Volume
Follow retention-ops.md and launch-scorecard.md weekly.
A healthy system always knows:
- what to review now
- what to practice next
- why the learner did or did not return
Common Traps
- Storing all subjects in one shared file -> topic collisions and broken continuity
- Activating without AGENTS router update -> skill never triggers when user asks to learn
- Adding many lessons before review queues exist -> fast forgetting and fake progress
- Running long lectures instead of micro-loops -> weak engagement and poor retention
- Using streak pressure without recovery path -> churn after one missed day
- Tracking only XP and ignoring checkpoint quality -> progress appears good while skill depth is low
Security & Privacy
Data that stays local:
- Learning state in
~/duolingo/ - Topic curriculum, attempts, and review queues
This skill does NOT:
- Send data to external services
- Access files outside
~/duolingo/unless user asks explicitly - Modify its own
SKILL.md
Related Skills
Install with clawhub install \x3Cslug> if user confirms:
learning- Teaching and explanation tactics per learner profileenglish- Language-specific practice patterns for one common trackcourse- Curriculum decomposition and sequence planningretention- Habit systems and comeback mechanicscoach- Accountability prompts and progress reflection
Feedback
- If useful:
clawhub star duolingo - Stay updated:
clawhub sync
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install duolingo - 安装完成后,直接呼叫该 Skill 的名称或使用
/duolingo触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Duolingo Learning OS 是什么?
Run a Duolingo-like multi-topic learning system with AGENTS routing, lesson loops, streaks, and spaced review. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 398 次。
如何安装 Duolingo Learning OS?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install duolingo」即可一键安装,无需额外配置。
Duolingo Learning OS 是免费的吗?
是的,Duolingo Learning OS 完全免费(开源免费),可自由下载、安装和使用。
Duolingo Learning OS 支持哪些平台?
Duolingo Learning OS 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(linux, darwin, win32)。
谁开发了 Duolingo Learning OS?
由 Iván(@ivangdavila)开发并维护,当前版本 v1.0.0。