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 ↗
npx degit michalparkola/tapestry-skills/ship-learn-next#main ~/.claude/skills/ship-learn-nextChecked ·commit main
Files of Ship-Learn-Next Action Planner
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:
- SHIP - Create something real (code, content, product, demonstration)
- LEARN - Honest reflection on what happened
- 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:
- "Based on this content, what do you want to achieve in 4-8 weeks?"
- "What would success look like? (Be specific)"
- "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.mdShip-Learn-Next Plan - Learn React.mdShip-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:
- Show them you've saved the plan: "✓ Saved to: [filename]"
- Give a brief overview of the quest
- Highlight Rep 1 (what's due this week)
Then ask:
- "When will you ship Rep 1?"
- "What's the one thing that might stop you? How will you handle it?"
- "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 | |
| 2 | name ship-learn-next |
| 3 | description 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. |
| 4 | allowed-tools Read,Write |
| 5 | |
| 6 | |
| 7 | # Ship-Learn-Next Action Planner |
| 8 | |
| 9 | This 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 | |
| 13 | Activate 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 | |
| 22 | Every learning quest follows three repeating phases: |
| 23 | |
| 24 | **SHIP** - Create something real (code, content, product, demonstration) |
| 25 | **LEARN** - Honest reflection on what happened |
| 26 | **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 | |
| 34 | Read the file the user provides (transcript, article, notes): |
| 35 | |
| 36 | |
| 37 | # User provides path to file |
| 38 | FILE_PATH="/path/to/content.txt" |
| 39 | |
| 40 | |
| 41 | Use the Read tool to analyze the content. |
| 42 | |
| 43 | ### Step 2: Extract Core Lessons |
| 44 | |
| 45 | Identify 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 | |
| 58 | Help the user frame their learning goal: |
| 59 | |
| 60 | Ask: |
| 61 | "Based on this content, what do you want to achieve in 4-8 weeks?" |
| 62 | "What would success look like? (Be specific)" |
| 63 | "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 | |
| 70 | Break down the quest into the **smallest shippable version**: |
| 71 | |
| 72 | Ask: |
| 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 | |
| 86 | Structure each rep with: |
| 87 | |
| 88 | |
| 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**: |
| 98 | 1. [Concrete step 1] |
| 99 | 2. [Concrete step 2] |
| 100 | 3. [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 | |
| 113 | Based on the content, suggest a progression: |
| 114 | |
| 115 | |
| 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 | |
| 133 | For 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 | |
| 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**: |
| 204 | 1. [Concrete step] |
| 205 | 2. [Concrete step] |
| 206 | 3. [Concrete step] |
| 207 | 4. 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**: |
| 213 | Answer 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 | |
| 272 | A 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 | |
| 288 | Always use the format: |
| 289 | `Ship-Learn-Next Plan - [Brief Quest Title].md` |
| 290 | |
| 291 | Examples: |
| 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**: |
| 315 | Show them you've saved the plan: "✓ Saved to: [filename]" |
| 316 | Give a brief overview of the quest |
| 317 | Highlight Rep 1 (what's due this week) |
| 318 | |
| 319 | **Then ask**: |
| 320 | "When will you ship Rep 1?" |
| 321 | "What's the one thing that might stop you? How will you handle it?" |
| 322 | "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 | |
| 326 | Let's help them ship. |
| 327 |
Discussion
Browse more free Claude skills.