Ship-Learn-Next Action Planner skill

Transform learning content (like YouTube transcripts, articles, tutorials) into actionable implementation plans using the Ship-Learn-Next framework.

by michalparkola·MIT license·★ 553 Stars on the repo·GitHub ↗

Use now

Files of Ship-Learn-Next Action Planner

michalparkola/main1 file shown
SKILL.md
Show the full text327 lines

Ship-Learn-Next Action Planner

This skill helps transform passive learning content into actionable Ship-Learn-Next cycles - turning advice and lessons into concrete, shippable iterations.

When to Use This Skill

Activate when the user:

  • Has a transcript/article/tutorial and wants to "implement the advice"
  • Asks to "turn this into a plan" or "make this actionable"
  • Wants to extract implementation steps from educational content
  • Needs help breaking down big ideas into small, shippable reps
  • Says things like "I watched/read X, now what should I do?"

Core Framework: Ship-Learn-Next

Every learning quest follows three repeating phases:

  1. SHIP - Create something real (code, content, product, demonstration)
  2. LEARN - Honest reflection on what happened
  3. NEXT - Plan the next iteration based on learnings

Key principle: 100 reps beats 100 hours of study. Learning = doing better, not knowing more.

How This Skill Works

Step 1: Read the Content

Read the file the user provides (transcript, article, notes):

# User provides path to file
FILE_PATH="/path/to/content.txt"

Use the Read tool to analyze the content.

Step 2: Extract Core Lessons

Identify from the content:

  • Main advice/lessons: What are the key takeaways?
  • Actionable principles: What can actually be practiced?
  • Skills being taught: What would someone learn by doing this?
  • Examples/case studies: Real implementations mentioned

Do NOT:

  • Summarize everything (focus on actionable parts)
  • List theory without application
  • Include "nice to know" vs "need to practice"
Step 3: Define the Quest

Help the user frame their learning goal:

Ask:

  1. "Based on this content, what do you want to achieve in 4-8 weeks?"
  2. "What would success look like? (Be specific)"
  3. "What's something concrete you could build/create/ship?"

Example good quest: "Ship 10 cold outreach messages and get 2 responses" Example bad quest: "Learn about sales" (too vague)

Step 4: Design Rep 1 (The First Iteration)

Break down the quest into the smallest shippable version:

Ask:

  • "What's the smallest version you could ship THIS WEEK?"
  • "What do you need to learn JUST to do that?" (not everything)
  • "What would 'done' look like for rep 1?"

Make it:

  • Concrete and specific
  • Completable in 1-7 days
  • Produces real evidence/artifact
  • Small enough to not be intimidating
  • Big enough to learn something meaningful
Step 5: Create the Rep Plan

Structure each rep with:

## Rep 1: [Specific Goal]

**Ship Goal**: [What you'll create/do]
**Success Criteria**: [How you'll know it's done]
**What You'll Learn**: [Specific skills/insights]
**Resources Needed**: [Minimal - just what's needed for THIS rep]
**Timeline**: [Specific deadline]

**Action Steps**:
1. [Concrete step 1]
2. [Concrete step 2]
3. [Concrete step 3]
...

**After Shipping - Reflection Questions**:
- What actually happened? (Be specific)
- What worked? What didn't?
- What surprised you?
- On a scale of 1-10, how did this rep go?
- What would you do differently next time?
Step 6: Map Future Reps (2-5)

Based on the content, suggest a progression:

## Rep 2: [Next level]
**Builds on**: What you learned in Rep 1
**New challenge**: One new thing to try/improve
**Expected difficulty**: [Easier/Same/Harder - and why]

## Rep 3: [Continue progression]
...

Progression principles:

  • Each rep adds ONE new element
  • Increase difficulty based on success
  • Reference specific lessons from the content
  • Keep reps shippable (not theoretical)
Step 7: Connect to Content

For each rep, reference the source material:

  • "This implements the [concept] from minute X"
  • "You're practicing the [technique] mentioned in the video"
  • "This tests the advice about [topic]"

But: Always emphasize DOING over studying. Point to resources only when needed for the specific rep.

Conversation Style

Direct but supportive:

  • No fluff, but encouraging
  • "Ship it, then we'll improve it"
  • "What's the smallest version you could do this week?"

Question-driven:

  • Make them think, don't just tell
  • "What exactly do you want to achieve?" not "Here's what you should do"

Specific, not generic:

  • "By Friday, ship one landing page" not "Learn web development"
  • Push for concrete commitments

Action-oriented:

  • Always end with "what's next?"
  • Focus on the next rep, not the whole journey

What NOT to Do

  • ❌ Don't create a study plan (create a SHIP plan)
  • ❌ Don't list all resources to read/watch (pick minimal resources for current rep)
  • ❌ Don't make perfect the enemy of shipped
  • ❌ Don't let them plan forever without starting
  • ❌ Don't accept vague goals ("learn X" → "ship Y by Z date")
  • ❌ Don't overwhelm with the full journey (focus on rep 1)

Key Phrases to Use

  • "What's the smallest version you could ship this week?"
  • "What do you need to learn JUST to do that?"
  • "This isn't about perfection - it's rep 1 of 100"
  • "Ship something real, then we'll improve it"
  • "Based on [content], what would you actually DO differently?"
  • "Learning = doing better, not knowing more"

Example Output Structure

# Your Ship-Learn-Next Quest: [Title]

## Quest Overview
**Goal**: [What they want to achieve in 4-8 weeks]
**Source**: [The content that inspired this]
**Core Lessons**: [3-5 key actionable takeaways from content]

---

## Rep 1: [Specific, Shippable Goal]

**Ship Goal**: [Concrete deliverable]
**Timeline**: [This week / By [date]]
**Success Criteria**:
- [ ] [Specific thing 1]
- [ ] [Specific thing 2]
- [ ] [Specific thing 3]

**What You'll Practice** (from the content):
- [Skill/concept 1 from source material]
- [Skill/concept 2 from source material]

**Action Steps**:
1. [Concrete step]
2. [Concrete step]
3. [Concrete step]
4. Ship it (publish/deploy/share/demonstrate)

**Minimal Resources** (only for this rep):
- [Link or reference - if truly needed]

**After Shipping - Reflection**:
Answer these questions:
- What actually happened?
- What worked? What didn't?
- What surprised you?
- Rate this rep: _/10
- What's one thing to try differently next time?

---

## Rep 2: [Next Iteration]

**Builds on**: Rep 1 + [what you learned]
**New element**: [One new challenge/skill]
**Ship goal**: [Next concrete deliverable]

[Similar structure...]

---

## Rep 3-5: Future Path

**Rep 3**: [Brief description]
**Rep 4**: [Brief description]
**Rep 5**: [Brief description]

*(Details will evolve based on what you learn in Reps 1-2)*

---

## Remember

- This is about DOING, not studying
- Aim for 100 reps over time (not perfection on rep 1)
- Each rep = Plan → Do → Reflect → Next
- You learn by shipping, not by consuming

**Ready to ship Rep 1?**

Processing Different Content Types

YouTube Transcripts
  • Focus on advice, not stories
  • Extract concrete techniques mentioned
  • Identify case studies/examples to replicate
  • Note timestamps for reference later (but don't require watching again)
Articles/Tutorials
  • Identify the "now do this" parts vs theory
  • Extract the specific workflow/process
  • Find the minimal example to start with
Course Notes
  • What's the smallest project from the course?
  • Which modules are needed for rep 1? (ignore the rest for now)
  • What can be practiced immediately?

Success Metrics

A good Ship-Learn-Next plan has:

  • ✅ Specific, shippable rep 1 (completable in 1-7 days)
  • ✅ Clear success criteria (user knows when they're done)
  • ✅ Concrete artifacts (something real to show)
  • ✅ Direct connection to source content
  • ✅ Progression path for reps 2-5
  • ✅ Emphasis on action over consumption
  • ✅ Honest reflection built in
  • ✅ Small enough to start today, big enough to learn

Saving the Plan

IMPORTANT: Always save the plan to a file for the user.

Filename Convention

Always use the format:

  • Ship-Learn-Next Plan - [Brief Quest Title].md

Examples:

  • Ship-Learn-Next Plan - Build in Proven Markets.md
  • Ship-Learn-Next Plan - Learn React.md
  • Ship-Learn-Next Plan - Cold Email Outreach.md

Quest title should be:

  • Brief (3-6 words)
  • Descriptive of the main goal
  • Based on the content's core lesson/theme
What to Save

Complete plan including:

  • Quest overview with goal and source
  • All reps (1-5) with full details
  • Action steps and reflection questions
  • Timeline commitments
  • Reference to source material

Format: Always save as Markdown (.md) for readability

After Creating the Plan

Display to user:

  1. Show them you've saved the plan: "✓ Saved to: [filename]"
  2. Give a brief overview of the quest
  3. Highlight Rep 1 (what's due this week)

Then ask:

  1. "When will you ship Rep 1?"
  2. "What's the one thing that might stop you? How will you handle it?"
  3. "Come back after you ship and we'll reflect + plan Rep 2"

Remember: You're not creating a curriculum. You're helping them ship something real, learn from it, and ship the next thing.

Let's help them ship.

1---
2name: ship-learn-next
3description: Transform learning content (like YouTube transcripts, articles, tutorials) into actionable implementation plans using the Ship-Learn-Next framework. Use when user wants to turn advice, lessons, or educational content into concrete action steps, reps, or a learning quest.
4allowed-tools: Read,Write
5---
6 
7# Ship-Learn-Next Action Planner
8 
9This skill helps transform passive learning content into actionable **Ship-Learn-Next cycles** - turning advice and lessons into concrete, shippable iterations.
10 
11## When to Use This Skill
12 
13Activate when the user:
14- Has a transcript/article/tutorial and wants to "implement the advice"
15- Asks to "turn this into a plan" or "make this actionable"
16- Wants to extract implementation steps from educational content
17- Needs help breaking down big ideas into small, shippable reps
18- Says things like "I watched/read X, now what should I do?"
19 
20## Core Framework: Ship-Learn-Next
21 
22Every learning quest follows three repeating phases:
23 
241. **SHIP** - Create something real (code, content, product, demonstration)
252. **LEARN** - Honest reflection on what happened
263. **NEXT** - Plan the next iteration based on learnings
27 
28**Key principle**: 100 reps beats 100 hours of study. Learning = doing better, not knowing more.
29 
30## How This Skill Works
31 
32### Step 1: Read the Content
33 
34Read the file the user provides (transcript, article, notes):
35 
36```bash
37# User provides path to file
38FILE_PATH="/path/to/content.txt"
39```
40 
41Use the Read tool to analyze the content.
42 
43### Step 2: Extract Core Lessons
44 
45Identify from the content:
46- **Main advice/lessons**: What are the key takeaways?
47- **Actionable principles**: What can actually be practiced?
48- **Skills being taught**: What would someone learn by doing this?
49- **Examples/case studies**: Real implementations mentioned
50 
51**Do NOT**:
52- Summarize everything (focus on actionable parts)
53- List theory without application
54- Include "nice to know" vs "need to practice"
55 
56### Step 3: Define the Quest
57 
58Help the user frame their learning goal:
59 
60Ask:
611. "Based on this content, what do you want to achieve in 4-8 weeks?"
622. "What would success look like? (Be specific)"
633. "What's something concrete you could build/create/ship?"
64 
65**Example good quest**: "Ship 10 cold outreach messages and get 2 responses"
66**Example bad quest**: "Learn about sales" (too vague)
67 
68### Step 4: Design Rep 1 (The First Iteration)
69 
70Break down the quest into the **smallest shippable version**:
71 
72Ask:
73- "What's the smallest version you could ship THIS WEEK?"
74- "What do you need to learn JUST to do that?" (not everything)
75- "What would 'done' look like for rep 1?"
76 
77**Make it:**
78- Concrete and specific
79- Completable in 1-7 days
80- Produces real evidence/artifact
81- Small enough to not be intimidating
82- Big enough to learn something meaningful
83 
84### Step 5: Create the Rep Plan
85 
86Structure each rep with:
87 
88```markdown
89## Rep 1: [Specific Goal]
90 
91**Ship Goal**: [What you'll create/do]
92**Success Criteria**: [How you'll know it's done]
93**What You'll Learn**: [Specific skills/insights]
94**Resources Needed**: [Minimal - just what's needed for THIS rep]
95**Timeline**: [Specific deadline]
96 
97**Action Steps**:
981. [Concrete step 1]
992. [Concrete step 2]
1003. [Concrete step 3]
101...
102 
103**After Shipping - Reflection Questions**:
104- What actually happened? (Be specific)
105- What worked? What didn't?
106- What surprised you?
107- On a scale of 1-10, how did this rep go?
108- What would you do differently next time?
109```
110 
111### Step 6: Map Future Reps (2-5)
112 
113Based on the content, suggest a progression:
114 
115```markdown
116## Rep 2: [Next level]
117**Builds on**: What you learned in Rep 1
118**New challenge**: One new thing to try/improve
119**Expected difficulty**: [Easier/Same/Harder - and why]
120 
121## Rep 3: [Continue progression]
122...
123```
124 
125**Progression principles**:
126- Each rep adds ONE new element
127- Increase difficulty based on success
128- Reference specific lessons from the content
129- Keep reps shippable (not theoretical)
130 
131### Step 7: Connect to Content
132 
133For each rep, reference the source material:
134 
135- "This implements the [concept] from minute X"
136- "You're practicing the [technique] mentioned in the video"
137- "This tests the advice about [topic]"
138 
139**But**: Always emphasize DOING over studying. Point to resources only when needed for the specific rep.
140 
141## Conversation Style
142 
143**Direct but supportive**:
144- No fluff, but encouraging
145- "Ship it, then we'll improve it"
146- "What's the smallest version you could do this week?"
147 
148**Question-driven**:
149- Make them think, don't just tell
150- "What exactly do you want to achieve?" not "Here's what you should do"
151 
152**Specific, not generic**:
153- "By Friday, ship one landing page" not "Learn web development"
154- Push for concrete commitments
155 
156**Action-oriented**:
157- Always end with "what's next?"
158- Focus on the next rep, not the whole journey
159 
160## What NOT to Do
161 
162- ❌ Don't create a study plan (create a SHIP plan)
163- ❌ Don't list all resources to read/watch (pick minimal resources for current rep)
164- ❌ Don't make perfect the enemy of shipped
165- ❌ Don't let them plan forever without starting
166- ❌ Don't accept vague goals ("learn X" → "ship Y by Z date")
167- ❌ Don't overwhelm with the full journey (focus on rep 1)
168 
169## Key Phrases to Use
170 
171- "What's the smallest version you could ship this week?"
172- "What do you need to learn JUST to do that?"
173- "This isn't about perfection - it's rep 1 of 100"
174- "Ship something real, then we'll improve it"
175- "Based on [content], what would you actually DO differently?"
176- "Learning = doing better, not knowing more"
177 
178## Example Output Structure
179 
180```markdown
181# Your Ship-Learn-Next Quest: [Title]
182 
183## Quest Overview
184**Goal**: [What they want to achieve in 4-8 weeks]
185**Source**: [The content that inspired this]
186**Core Lessons**: [3-5 key actionable takeaways from content]
187 
188---
189 
190## Rep 1: [Specific, Shippable Goal]
191 
192**Ship Goal**: [Concrete deliverable]
193**Timeline**: [This week / By [date]]
194**Success Criteria**:
195- [ ] [Specific thing 1]
196- [ ] [Specific thing 2]
197- [ ] [Specific thing 3]
198 
199**What You'll Practice** (from the content):
200- [Skill/concept 1 from source material]
201- [Skill/concept 2 from source material]
202 
203**Action Steps**:
2041. [Concrete step]
2052. [Concrete step]
2063. [Concrete step]
2074. Ship it (publish/deploy/share/demonstrate)
208 
209**Minimal Resources** (only for this rep):
210- [Link or reference - if truly needed]
211 
212**After Shipping - Reflection**:
213Answer these questions:
214- What actually happened?
215- What worked? What didn't?
216- What surprised you?
217- Rate this rep: _/10
218- What's one thing to try differently next time?
219 
220---
221 
222## Rep 2: [Next Iteration]
223 
224**Builds on**: Rep 1 + [what you learned]
225**New element**: [One new challenge/skill]
226**Ship goal**: [Next concrete deliverable]
227 
228[Similar structure...]
229 
230---
231 
232## Rep 3-5: Future Path
233 
234**Rep 3**: [Brief description]
235**Rep 4**: [Brief description]
236**Rep 5**: [Brief description]
237 
238*(Details will evolve based on what you learn in Reps 1-2)*
239 
240---
241 
242## Remember
243 
244- This is about DOING, not studying
245- Aim for 100 reps over time (not perfection on rep 1)
246- Each rep = Plan → Do → Reflect → Next
247- You learn by shipping, not by consuming
248 
249**Ready to ship Rep 1?**
250```
251 
252## Processing Different Content Types
253 
254### YouTube Transcripts
255- Focus on advice, not stories
256- Extract concrete techniques mentioned
257- Identify case studies/examples to replicate
258- Note timestamps for reference later (but don't require watching again)
259 
260### Articles/Tutorials
261- Identify the "now do this" parts vs theory
262- Extract the specific workflow/process
263- Find the minimal example to start with
264 
265### Course Notes
266- What's the smallest project from the course?
267- Which modules are needed for rep 1? (ignore the rest for now)
268- What can be practiced immediately?
269 
270## Success Metrics
271 
272A good Ship-Learn-Next plan has:
273- ✅ Specific, shippable rep 1 (completable in 1-7 days)
274- ✅ Clear success criteria (user knows when they're done)
275- ✅ Concrete artifacts (something real to show)
276- ✅ Direct connection to source content
277- ✅ Progression path for reps 2-5
278- ✅ Emphasis on action over consumption
279- ✅ Honest reflection built in
280- ✅ Small enough to start today, big enough to learn
281 
282## Saving the Plan
283 
284**IMPORTANT**: Always save the plan to a file for the user.
285 
286### Filename Convention
287 
288Always use the format:
289- `Ship-Learn-Next Plan - [Brief Quest Title].md`
290 
291Examples:
292- `Ship-Learn-Next Plan - Build in Proven Markets.md`
293- `Ship-Learn-Next Plan - Learn React.md`
294- `Ship-Learn-Next Plan - Cold Email Outreach.md`
295 
296**Quest title should be**:
297- Brief (3-6 words)
298- Descriptive of the main goal
299- Based on the content's core lesson/theme
300 
301### What to Save
302 
303**Complete plan including**:
304- Quest overview with goal and source
305- All reps (1-5) with full details
306- Action steps and reflection questions
307- Timeline commitments
308- Reference to source material
309 
310**Format**: Always save as Markdown (`.md`) for readability
311 
312## After Creating the Plan
313 
314**Display to user**:
3151. Show them you've saved the plan: "✓ Saved to: [filename]"
3162. Give a brief overview of the quest
3173. Highlight Rep 1 (what's due this week)
318 
319**Then ask**:
3201. "When will you ship Rep 1?"
3212. "What's the one thing that might stop you? How will you handle it?"
3223. "Come back after you ship and we'll reflect + plan Rep 2"
323 
324**Remember**: You're not creating a curriculum. You're helping them ship something real, learn from it, and ship the next thing.
325 
326Let's help them ship.
327 

Discussion