$npx -y skills add michalparkola/tapestry-skills --skill ship-learn-nextTransform 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.
| 1 | # Ship-Learn-Next Action Planner |
| 2 | |
| 3 | This skill helps transform passive learning content into actionable **Ship-Learn-Next cycles** - turning advice and lessons into concrete, shippable iterations. |
| 4 | |
| 5 | ## When to Use This Skill |
| 6 | |
| 7 | Activate when the user: |
| 8 | - Has a transcript/article/tutorial and wants to "implement the advice" |
| 9 | - Asks to "turn this into a plan" or "make this actionable" |
| 10 | - Wants to extract implementation steps from educational content |
| 11 | - Needs help breaking down big ideas into small, shippable reps |
| 12 | - Says things like "I watched/read X, now what should I do?" |
| 13 | |
| 14 | ## Core Framework: Ship-Learn-Next |
| 15 | |
| 16 | Every learning quest follows three repeating phases: |
| 17 | |
| 18 | 1. **SHIP** - Create something real (code, content, product, demonstration) |
| 19 | 2. **LEARN** - Honest reflection on what happened |
| 20 | 3. **NEXT** - Plan the next iteration based on learnings |
| 21 | |
| 22 | **Key principle**: 100 reps beats 100 hours of study. Learning = doing better, not knowing more. |
| 23 | |
| 24 | ## How This Skill Works |
| 25 | |
| 26 | ### Step 1: Read the Content |
| 27 | |
| 28 | Read the file the user provides (transcript, article, notes): |
| 29 | |
| 30 | ```bash |
| 31 | # User provides path to file |
| 32 | FILE_PATH="/path/to/content.txt" |
| 33 | ``` |
| 34 | |
| 35 | Use the Read tool to analyze the content. |
| 36 | |
| 37 | ### Step 2: Extract Core Lessons |
| 38 | |
| 39 | Identify from the content: |
| 40 | - **Main advice/lessons**: What are the key takeaways? |
| 41 | - **Actionable principles**: What can actually be practiced? |
| 42 | - **Skills being taught**: What would someone learn by doing this? |
| 43 | - **Examples/case studies**: Real implementations mentioned |
| 44 | |
| 45 | **Do NOT**: |
| 46 | - Summarize everything (focus on actionable parts) |
| 47 | - List theory without application |
| 48 | - Include "nice to know" vs "need to practice" |
| 49 | |
| 50 | ### Step 3: Define the Quest |
| 51 | |
| 52 | Help the user frame their learning goal: |
| 53 | |
| 54 | Ask: |
| 55 | 1. "Based on this content, what do you want to achieve in 4-8 weeks?" |
| 56 | 2. "What would success look like? (Be specific)" |
| 57 | 3. "What's something concrete you could build/create/ship?" |
| 58 | |
| 59 | **Example good quest**: "Ship 10 cold outreach messages and get 2 responses" |
| 60 | **Example bad quest**: "Learn about sales" (too vague) |
| 61 | |
| 62 | ### Step 4: Design Rep 1 (The First Iteration) |
| 63 | |
| 64 | Break down the quest into the **smallest shippable version**: |
| 65 | |
| 66 | Ask: |
| 67 | - "What's the smallest version you could ship THIS WEEK?" |
| 68 | - "What do you need to learn JUST to do that?" (not everything) |
| 69 | - "What would 'done' look like for rep 1?" |
| 70 | |
| 71 | **Make it:** |
| 72 | - Concrete and specific |
| 73 | - Completable in 1-7 days |
| 74 | - Produces real evidence/artifact |
| 75 | - Small enough to not be intimidating |
| 76 | - Big enough to learn something meaningful |
| 77 | |
| 78 | ### Step 5: Create the Rep Plan |
| 79 | |
| 80 | Structure each rep with: |
| 81 | |
| 82 | ```markdown |
| 83 | ## Rep 1: [Specific Goal] |
| 84 | |
| 85 | **Ship Goal**: [What you'll create/do] |
| 86 | **Success Criteria**: [How you'll know it's done] |
| 87 | **What You'll Learn**: [Specific skills/insights] |
| 88 | **Resources Needed**: [Minimal - just what's needed for THIS rep] |
| 89 | **Timeline**: [Specific deadline] |
| 90 | |
| 91 | **Action Steps**: |
| 92 | 1. [Concrete step 1] |
| 93 | 2. [Concrete step 2] |
| 94 | 3. [Concrete step 3] |
| 95 | ... |
| 96 | |
| 97 | **After Shipping - Reflection Questions**: |
| 98 | - What actually happened? (Be specific) |
| 99 | - What worked? What didn't? |
| 100 | - What surprised you? |
| 101 | - On a scale of 1-10, how did this rep go? |
| 102 | - What would you do differently next time? |
| 103 | ``` |
| 104 | |
| 105 | ### Step 6: Map Future Reps (2-5) |
| 106 | |
| 107 | Based on the content, suggest a progression: |
| 108 | |
| 109 | ```markdown |
| 110 | ## Rep 2: [Next level] |
| 111 | **Builds on**: What you learned in Rep 1 |
| 112 | **New challenge**: One new thing to try/improve |
| 113 | **Expected difficulty**: [Easier/Same/Harder - and why] |
| 114 | |
| 115 | ## Rep 3: [Continue progression] |
| 116 | ... |
| 117 | ``` |
| 118 | |
| 119 | **Progression principles**: |
| 120 | - Each rep adds ONE new element |
| 121 | - Increase difficulty based on success |
| 122 | - Reference specific lessons from the content |
| 123 | - Keep reps shippable (not theoretical) |
| 124 | |
| 125 | ### Step 7: Connect to Content |
| 126 | |
| 127 | For each rep, reference the source material: |
| 128 | |
| 129 | - "This implements the [concept] from minute X" |
| 130 | - "You're practicing the [technique] mentioned in the video" |
| 131 | - "This tests the advice about [topic]" |
| 132 | |
| 133 | **But**: Always emphasize DOING over studying. Point to resources only when needed for the specific rep. |
| 134 | |
| 135 | ## Conversation Style |
| 136 | |
| 137 | **Direct but supportive**: |
| 138 | - No fluff, but encouraging |
| 139 | - "Ship it, then we'll improve it" |
| 140 | - "What's the smallest version you could do this week?" |
| 141 | |
| 142 | **Question-driven**: |
| 143 | - Make them think, don't just tell |
| 144 | - "What exactly do you want to achieve?" not "Here's what you should do" |
| 145 | |
| 146 | **Specific, not generic**: |
| 147 | - "By Friday, ship one landing page" not "Learn web development" |
| 148 | - Push for concrete commitments |
| 149 | |
| 150 | **Action-oriented**: |
| 151 | - Always end with "what's next?" |
| 152 | - Focus on the next rep, not the whole journey |
| 153 | |
| 154 | ## What NOT to Do |
| 155 | |
| 156 | - ❌ Don't create a study plan (create a SHIP plan) |
| 157 | - ❌ Don't list all resources to read/watch (pick minimal resources for current rep) |
| 158 | - ❌ Don't make perfect the |