axel-pm/watch-n-learn / skills/watch-and-learn
watch-and-learn
VerifiedWatch a how-to / tutorial / demo video and turn the procedure it teaches into one or more working Claude Code skills. Use when the user wants to "turn this video into a skill", "watch this tutorial and make a skill", "learn how to do X from this video", "build a skill from this screencast/demo/talk", or capture a repeatable workflow shown in a video. Sends an agent to watch the video (local file or URL) with a local, free, no-API toolchain, breaks the procedure down, authors the skill(s), and verifies they actually work.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.3 KB |
| references/procedure-spec-template.md | markdown | 1.5 KB |
| references/qualifying.md | markdown | 2.9 KB |
| references/skill-authoring.md | markdown | 2.5 KB |
| references/validation-checklist.md | markdown | 1.8 KB |
| references/watching.md | markdown | 4.6 KB |
| scripts/install-tools.shexecutable | script | 1.7 KB |
| scripts/validate_skill.py | script | 4.4 KB |
| scripts/watch.py | script | 16.3 KB |
references/validation-checklist.md
View on GitHub# validation-checklist.md — proving an authored skill works
"Make sure the skill works" is a required step, not a nicety. Two layers:
## Layer 1 — structural (automated)
```sh
python3 scripts/validate_skill.py <path-to-new-skill>
```
Checks: valid frontmatter, kebab-case `name` matching the folder, a real `description`, a non-empty
instruction body, referenced `scripts/` & `references/` files exist, and every bundled `.py` compiles.
Fix everything it flags before Layer 2.
## Layer 2 — rehearsal (the real test)
A skill is only proven when a *fresh* agent, given only the skill, can do the task.
1. Pick a **realistic test task** the skill should handle (ideally the same thing the video did, or a
close variant).
2. Spawn a **fresh subagent** (Agent tool) whose context contains **only**:
- the new `SKILL.md` (+ its references/scripts), and
- the test task.
Do **not** feed it the video digest or your procedure spec — it must succeed from the skill alone.
3. Watch what it does. The skill passes if the subagent:
- triggers on / follows the intended workflow,
- produces a **correct** result,
- without needing information the skill failed to include.
4. If it stumbles, the skill is underspecified or mis-scoped. Note exactly where it got stuck,
revise the `SKILL.md` (add the missing step, tighten a command, split an overloaded skill),
and rehearse again. Iterate until it passes cleanly.
## What "correct" means
Define the pass condition **before** rehearsing (a file that should exist, output that should match,
a state that should hold), then check it objectively — don't grade on "looks plausible."
## Record the result
Note in your summary: the test task, pass/fail, and any revisions made. A skill that shipped without a
recorded rehearsal should be treated as a draft.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |