ship-learn-next

ship-learn-next 스킬 개요

ship-learn-next 스킬은 이미 손에 쥔 학습 자료를 빠르게 실행으로 바꾸고 싶은 사람을 위한 계획형 스킬입니다. 튜토리얼, 녹취록, 아티클, 강의 노트를 요약하는 대신, 이 스킬은 해당 자료를 구체적인 반복 실습이 가능한 Ship → Learn → Next 사이클로 전환하도록 에이전트를 밀어줍니다.

ship-learn-next가 실제로 하도록 설계된 일

ship-learn-next 스킬의 핵심 역할은 “내용을 설명해 주는 것”이 아닙니다. 이 스킬이 답하려는 질문은 “이 자료를 바탕으로 내가 실제로 무엇을 만들고, 시도하고, 돌아보고, 다음에 무엇을 해야 하는가?”입니다. 그래서 수동적인 학습 보조보다 구현 계획 수립에 더 잘 맞습니다.

가장 잘 맞는 사용자

이 스킬이 특히 유용한 사람은 다음과 같습니다.

• 적용해 보고 싶은 transcript, article, tutorial을 이미 갖고 있는 빌더
• 조언은 많이 소비했지만 첫 번째 실제 실습으로 넘어가지 못한 사람
• 학습 계획보다 실전 루프를 선호하는 코치, 운영자, 자기주도 학습자
• 콘텐츠 요약이 아니라 구조화된 실행 계획이 필요한 Playbooks 내부 에이전트

일반적인 프롬프트와의 가장 큰 차이점

일반적인 프롬프트는 깔끔한 요약과 두루뭉술한 다음 단계로 끝나는 경우가 많습니다. 반면 ship-learn-next는 분명한 방향성을 갖습니다. 즉, 실제로 배포하거나 내놓을 수 있는 결과물, 솔직한 회고, 그리고 다음 반복에 초점을 둡니다. 더 읽는 것보다 추진력, 피드백, 실제 연습이 필요한 상황이라면 이 편향이 중요합니다.

설치 전에 꼭 봐야 할 점

이 스킬은 가볍고 이해하기 쉽지만, 소스 자료의 질과 사용자 브리프에 크게 의존합니다. 사용자의 제약, 숙련도, 작업 환경을 자동으로 알아서 파악해 주지는 않습니다. “이걸 실행 가능하게 만들어 줘” 정도만 주면 결과도 일반적인 계획이 되기 쉽습니다. 반대로 자료 자체와 함께 목표 결과, 가용 시간, 맥락을 주면 훨씬 실용적인 출력이 나옵니다.

Playbooks 워크플로에서 ship-learn-next가 들어가는 위치

Playbooks에서 ship-learn-next는 콘텐츠를 수집한 뒤, 실행에 들어가기 직전에 가장 잘 맞습니다. 실무적으로는 다음 패턴이 자연스럽습니다.

1. transcript, notes, article text를 모은다
2. ship-learn-next를 실행해 첫 번째 액션 사이클을 만든다
3. 한 번 실제로 수행한다
4. 그 결과를 다음 계획 수립 단계에 다시 넣는다

즉, “뭔가를 배웠다”에서 “뭔가를 실제로 만들었다”로 넘어가는 다리 역할을 합니다.

ship-learn-next 스킬 사용 방법

ship-learn-next 설치 맥락

이 저장소는 softaworks/agent-toolkit의 skills/ship-learn-next 아래에 있습니다. 사용 중인 skills runner가 GitHub에서 직접 스킬 설치를 지원한다면, 흔히 쓰는 패턴은 다음과 같습니다.

npx skills add softaworks/agent-toolkit --skill ship-learn-next

환경에 따라 다른 설치 방식을 쓴다면 위의 repo path를 사용하고, skill slug가 정확히 ship-learn-next인지 확인하세요.

먼저 읽어야 할 파일

저장소는 짧게만 훑어봐도 충분합니다.

• 실제 워크플로는 skills/ship-learn-next/SKILL.md
• 상위 레벨의 의도는 skills/ship-learn-next/README.md

이 스킬에는 눈에 띄는 helper script나 reference folder가 없기 때문에, 핵심은 프레임워크를 이해하고 더 좋은 입력을 넣는 데 있습니다.

ship-learn-next에 필요한 입력

최소한 ship-learn-next 스킬에는 다음이 필요합니다.

• 학습 콘텐츠 자체: transcript, article, tutorial notes, course notes
• 그것을 적용하려는 도메인 또는 프로젝트
• 현재 수준: beginner, intermediate, advanced
• 실무 제약: 사용 가능한 시간, 도구, 마감일, 플랫폼, 대상 독자/사용자

실제 콘텐츠가 없으면 이 스킬은 평범한 계획 프롬프트가 됩니다. 강점은 현실 자료에서 교훈을 끌어내는 데 있습니다.

잘 맞는 소스 자료 형식

강한 입력:

• 정리된 article 본문
• 화자 맥락이 포함된 transcript
• heading 구조가 있는 notes
• code snippet이나 example이 포함된 tutorial 단계

약한 입력:

• “대충 기억나는” 수준의 모호한 요약
• 인용문 하나 없이 링크만 던지는 요청
• 주제가 분명하지 않게 심하게 쪼개진 notes
• 구체적인 전술 없이 동기부여만 하는 콘텐츠

거친 목표를 강한 프롬프트로 바꾸는 법

약한 프롬프트:

I watched this video. Make it actionable.

더 강한 프롬프트:

Use ship-learn-next on this transcript. My goal is to practice Next.js routing by shipping one small feature today. I have 90 minutes, I’m an intermediate React developer, and I want a plan with one first rep, one reflection checklist, and one follow-up iteration. Optimize for shipping, not theory.

이 방식이 잘 먹히는 이유:

• 어떤 역량 영역을 다룰지 지정해 준다
• 시간 박스를 설정한다
• 원하는 출력 형태를 분명히 한다
• 프레임워크의 “먼저 ship” 편향을 다시 한번 못 박아 준다

실전적인 ship-learn-next 사용 패턴

ship-learn-next를 잘 쓰는 워크플로는 보통 이렇습니다.

1. 콘텐츠를 붙여 넣거나 위치를 지정한다
2. 그 콘텐츠로부터 원하는 결과를 말한다
3. 거대한 로드맵이 아니라 첫 번째로 ship 가능한 실습 하나를 요청한다
4. 그 실습을 수행한다
5. 실제로 무슨 일이 있었는지 다시 가져온다
6. 그 결과를 바탕으로 다음 사이클을 요청한다

이렇게 해야 프레임워크가 공허해지지 않습니다. ship-learn-next는 한 번에 끝나는 마스터플랜 생성기보다, 반복적으로 쓸 때 훨씬 강합니다.

이런 구조의 출력을 요청하세요

더 나은 결과를 원한다면 다음 같은 구조화된 응답을 요청하세요.

• 콘텐츠에서 추출한 핵심 교훈
• 지금 바로 ship할 수 있는 작은 결과물 하나
• 성공 기준
• 예상되는 방해 요소
• 완료 후 돌아볼 질문
• 다음 반복 옵션

이 구조는 기본 Ship → Learn → Next 로직과 잘 맞고, 추상적인 조언을 줄여 줍니다.

ship-learn-next와 요약의 차이

다음만 원한다면 ship-learn-next를 쓰지 않는 편이 낫습니다.

• bullet summary
• 핵심 인용문
• 개념 설명
• 콘텐츠 비평

이 스킬은 구현 계획이 필요할 때 써야 합니다. 요약만 요청한다면 사실상 이 스킬의 차별점을 쓰지 못하는 셈입니다.

Playbooks용 실전 프롬프트 예시

운영자용:

Run ship-learn-next on these founder notes and turn them into a 3-day execution loop for validating one customer pain point.

개발자용:

Use ship-learn-next on this tutorial transcript and convert it into one coding rep I can finish tonight, plus the next two iterations if the first one works.

크리에이터용:

Apply ship-learn-next to this writing advice article and produce a 7-day publish-review-improve cycle with one artifact per day.

흔한 사용 실수

ship-learn-next 출력이 밋밋하고 일반적으로 느껴지는 가장 흔한 이유는 다음과 같습니다.

• source text를 넣지 않음
• 시간이나 범위를 제한하지 않음
• 첫 실습이 아니라 전체 커리큘럼을 요구함
• 무엇이 “shipped”로 간주되는지 지정하지 않음
• 다음 사이클을 위해 실제 결과를 다시 가져오지 않음

출력 품질을 판단하는 기준

좋은 ship-learn-next 결과라면 다음을 줘야 합니다.

• 실제로 만들거나, 테스트하거나, 게시할 수 있는 구체적인 무언가
• 완료 가능한 수준으로 작게 잡힌 범위
• 실행과 연결된 회고 프롬프트
• 피드백이나 마찰을 바탕으로 한 그럴듯한 다음 수

출력이 학습 노트처럼 느껴진다면 브리프를 더 구체화하고, 더 작고 관찰 가능한 결과물을 요구하세요.

ship-learn-next 스킬 FAQ

ship-learn-next는 초보자에게도 괜찮나요?

그렇습니다. 단, 자신의 수준을 분명히 알려 주고 아주 작은 실습 단위로 요청해야 합니다. 초보자는 너무 큰 전체 프로젝트 계획을 요청해서 실패하는 경우가 많습니다. ship-learn-next 스킬에게 첫 액션을 단일하고 끝낼 수 있는 결과물 하나로 줄여 달라고 요청하세요.

일반적인 AI 프롬프트보다 더 낫나요?

대체로 그렇습니다. 특히 문제의 본질이 “알겠는데 실행이 안 되는 상태”라면 더 그렇습니다. 이 스킬은 모델에 더 명확한 행동 프레임을 줍니다. 즉, 교훈을 뽑고, 실제로 하나를 만들고, 돌아본 뒤, 다음 단계를 계획하게 합니다. 그래서 단순한 “다음에 뭘 해야 하지?” 프롬프트보다 실제로 쓸 만한 실행 계획이 나오는 편입니다.

언제 ship-learn-next를 쓰지 말아야 하나요?

다음이 필요하다면 건너뛰세요.

• 깊이 있는 주제 설명
• fact-checking 또는 source verification
• runtime error 기반 code debugging
• 순수 요약
• 장문의 course syllabus

이 스킬은 실행 지향적이지, 만능 학습 보조 도구는 아닙니다.

ship-learn-next는 특정 toolchain이 필요한가요?

아니요. 저장소에서 복잡한 toolchain이 드러나지는 않습니다. 스킬 자체는 주로 사용자가 제공한 콘텐츠를 읽고 계획을 작성하는 데 의존합니다. 그래서 도입은 간단하지만, 그만큼 품질은 자동화보다 입력에 더 많이 좌우됩니다.

ship-learn-next를 비기술 주제에도 쓸 수 있나요?

네. 이 프레임워크는 writing, content creation, operations, sales practice, product thinking 같은 다양한 역량 개발 영역에 충분히 넓게 적용됩니다. 핵심은 소스 자료 안에 실제 실습으로 바꿀 수 있는 조언이 들어 있어야 한다는 점입니다.

ship-learn-next는 Playbooks 전용인가요?

아닙니다. 다만 Playbooks용 ship-learn-next는 매우 자연스러운 조합입니다. Playbooks는 반복 가능한 실행 루프가 필요한 경우가 많기 때문입니다. 입력, 행동, 결과를 이미 추적하는 워크플로라면, 이 스킬은 학습 자료와 실제 작업 사이를 잇는 계획 레이어로 잘 작동합니다.

ship-learn-next 스킬 개선 방법

ship-learn-next에 더 촘촘한 제약을 주세요

ship-learn-next 출력을 개선하는 가장 좋은 방법은 첫 번째 실습에 강한 제약을 거는 것입니다.

• time box: 30 minutes, 2 hours, 1 day
• artifact: landing page, CLI script, thread draft, customer email
• environment: local only, no paid tools, mobile-first, beginner Python

경계가 구체적일수록 계획은 추상화가 아니라 실행 쪽으로 밀립니다.

콘텐츠만이 아니라 실행 맥락도 함께 주세요

더 좋은 입력에는 이런 정보가 포함됩니다.

• 이미 알고 있는 것
• 이미 시도해 본 것
• 조언을 적용할 장소나 상황
• 무엇을 “done”으로 볼지
• 어떤 상태를 실패로 볼지

이 정보가 있어야 ship-learn-next가 일반적인 첫 사이클이 아니라 현실적인 첫 사이클을 만들 수 있습니다.

첫 실습을 더 작게 요청하세요

흔한 실패 패턴은 범위를 너무 크게 잡는 것입니다. 출력이 지나치게 야심차게 들리면 이렇게 명시적으로 요청하세요.

Rewrite this ship-learn-next plan so the first rep can be completed in one sitting and produce a visible result.

이 한마디만으로도 보통 즉시 실용성이 좋아집니다.

출력에 회고 기준을 강제로 넣으세요

사용자가 작업 목록만 받아들이면 Learn 단계가 약해집니다. 다음을 요청하세요.

• 작업 중 무엇을 관찰해야 하는지
• ship 후 무엇을 측정해야 하는지
• 어떤 신호가 다음 반복을 정당화하는지

이렇게 해야 사이클이 동기부여 중심이 아니라 근거 중심이 됩니다.

의견이 아니라 실제 결과로 반복하세요

첫 실행 후에는 구체적으로 다시 가져오세요.

• 무엇을 ship했는지
• 어디에서 막혔는지
• 예상보다 쉬웠던 점은 무엇인지
• 무엇이 실패했는지
• 어떤 피드백이나 지표를 얻었는지

그다음 ship-learn-next에게 그 결과를 바탕으로 다음 사이클을 생성하게 하세요. 이 지점에서 이 프레임워크는 일회성 계획보다 더 큰 가치를 냅니다.

일반적인 출력을 명시적 재작성으로 바로잡으세요

첫 답변이 너무 넓으면 다음 같은 재작성을 요청하세요.

• “Make the plan more concrete.”
• “Reduce this to one rep.”
• “Tie each step back to a lesson from the source.”
• “Add failure conditions and reflection prompts.”
• “Optimize for speed to first ship.”

이 지시들은 스킬의 핵심 의도와 잘 맞습니다.

ship-learn-next를 저장소 읽기 습관과 함께 쓰세요

저장소가 작기 때문에, 본격적으로 의존하기 전에 SKILL.md를 한 번 읽어볼 가치가 충분합니다. 그러면 이 스킬이 왜 실전 루프를 선호하는지 감이 오고, 프롬프트도 훨씬 잘 쓸 수 있습니다. 특히 ship-learn-next 사용을 더 큰 운영 워크플로 안에 넣으려는 경우에 도움이 큽니다.

가장 큰 한계를 알고 쓰세요

ship-learn-next는 학습 자료를 액션 플랜으로 바꾸는 데 강하지만, 도메인 판단 자체를 대신해 주지는 않습니다. 소스 콘텐츠가 부실하거나, 오래됐거나, 현재 맥락과 맞지 않으면 계획이 구조적으로는 좋아 보여도 전략적으로 틀릴 수 있습니다. 소스를 개선하면 출력도 함께 좋아집니다.