How SKILL.md Files Let AI Agents Learn From Watching You

What if teaching an AI agent was as simple as showing it what to do? Not writing code. Not defining selectors. Just... demonstrating the task and letting the AI figure out the rest. That's the idea behind SKILL.md files. The Learning Problem AI agents are powerful, but they're only as capable as the skills we give them. Today, defining those skills means writing code—brittle, maintenance-heavy code that breaks when websites change. But humans don't learn this way. We learn by watching, imitating, and practicing. Why can't AI agents do the same? Learning From Demonstration SKILL.md files enable a new learning paradigm: 1. Demonstrate Record yourself performing a task. Any web-based workflow—booking a meeting, filling a form, extracting data. 2. Extract AI analyzes the recording and extracts: What you're trying to accomplish (goals) The sequence of actions (workflows) UI elements you interact with (context) Error conditions and edge cases 3. Encode The result is a structured, human-reada