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-readable file:
# Book a Meeting
## Goal
Schedule a 30-minute meeting on Google Calendar
## Workflow
1. Navigate to calendar.google.com
2. Click "Create" button
3. Fill title, date, time
4. Add attendees
5. Send invitation
## Context
- "Create" button: Primary CTA
- Title field: Text input
- Attendees: Email input with autocomplete
## Error Handling
- If time slot is taken, suggest alternatives
- If attendee doesn't exist, prompt for correction
4. Execute
Any compatible AI agent can read this file and perform the task.
Why This Changes Everything
Democratizes automation: Domain experts can create skills without coding.
Survives change: Skills describe intent, not implementation. When UIs update, the AI adapts.
Portable: The same skill works across AutoGen, LangChain, CrewAI, and custom agents.
Auditable: Human-readable format means you can review what the agent will do before it runs.
The npm Moment for AI Agents
Think about software before package managers. Everyone reimplemented the same functionality because there was no standard way to share code.
SKILL.md is that standard for agent capabilities. A universal format for describing what agents can do.
Imagine a world where:
- An HR specialist records onboarding workflows
- A sales rep records CRM procedures
- A finance analyst records reporting tasks
And all of these become reusable skills that any AI agent can execute.
Making It Real
This isn't theoretical. SkillForge implements this entire pipeline today:
- Upload a screen recording
- AI generates the SKILL.md file
- Deploy to your agents
Live on Product Hunt:
🔗 https://www.producthunt.com/products/skillforge-2
The Bigger Picture
We're moving from an era where we tell computers exactly what to do, to an era where we show them what we want and let them figure out how.
SKILL.md files are the bridge between human expertise and AI execution.
What skills will you teach your agents?
Top comments (0)