writing-shape

writing-shape 스킬 개요

writing-shape은 markdown “덩어리”를 출판 가능한 글로 바꾸기 위해, 구조적 선택을 하나씩 함께 풀어가는 대화형 초안 작성 스킬입니다. 이미 원자료는 있지만, 최종 글의 관점, 도입, 전체 구조를 잡는 데 도움이 필요한 작가, 기술 마케터, 편집자에게 가장 잘 맞습니다.

어떤 용도인가

writing-shape은 “처음부터 써 달라”가 아니라 “이 거친 재료를 일관된 글로 다듬어 달라”는 작업에 쓰는 스킬입니다. 인터뷰 메모, 녹취 정리, 초안 조각, 그리고 내러티브가 더 강해져야 마무리할 수 있는 기술 문서에 특히 잘 맞습니다.

무엇이 다른가

writing-shape 스킬은 단순히 소스를 요약하는 데서 끝나지 않습니다. 여러 후보 도입부 중 하나를 고르게 한 뒤, 구조를 함께 논의하면서 문단 단위로 글을 쌓아 갑니다. 그래서 사실만큼이나 순서, 강조점, 형식이 중요한 글에 유용합니다.

적합한 경우와 한계

정리되지 않은 입력에서 읽기 쉬운 글을 만들고 싶을 때 Technical Writing에 잘 맞는 선택입니다. 다만 주제 전문가의 판단을 대신해 주지는 못합니다. 다듬어진 문장을 대화 없이 빠르게 만들고 싶다면 일반 프롬프트가 더 빠를 수 있고, 편집 과정을 안내받으며 진행하고 싶다면 writing-shape이 더 나은 설치 선택입니다.

writing-shape 스킬 사용법

설치 및 세션 설정

npx skills add mattpocock/skills --skill writing-shape로 설치합니다. 그다음 원본 markdown 파일과 대상 글의 경로를 주고 세션을 시작하거나, 아직 정하지 않았다면 경로 선택부터 맡겨도 됩니다. 이 스킬은 원본 자료를 읽기 전용으로 다루고, 실제 글 파일은 매번 작성 전에 다시 읽는 흐름을 전제로 합니다.

어떤 입력을 주면 좋은가

writing-shape을 가장 잘 쓰려면 세 가지가 필요합니다. 원본 메모, 의도한 독자, 원하는 최종 결과입니다. 예를 들어 “이 메모를 신규 플랫폼 엔지니어를 위한 실용 가이드로 다듬어 줘”는 “더 좋게 만들어 줘”보다 훨씬 낫습니다. 전자는 스킬이 어떤 논지, 독자, 디테일 수준을 최적화해야 하는지 분명하게 알려 주기 때문입니다.

권장 워크플로

먼저 원본 파일을 열고 처음부터 끝까지 읽은 뒤, 스킬이 2~3개의 후보 도입부를 제안하게 하세요. 글의 실제 역할에 가장 잘 맞는 도입부를 고른 다음, 독자가 다음에 무엇을 알아야 하는지 한 단계씩 물으며 진행합니다. writing-shape이 가장 빛나는 지점이 바로 여기입니다. 초안의 흐름을 유지하면서도, 전개가 드러나는 과정에서 구조를 다시 빚을 수 있게 해 줍니다.

먼저 읽어야 할 파일

먼저 SKILL.md를 열고, 그다음 README.md, AGENTS.md, metadata.json처럼 이 스킬이 참조하는 주변 저장소 안내가 있으면 함께 확인하세요. 이 저장소에서 핵심 가치는 SKILL.md 자체에 있으므로, 실제 판단은 “숨은 보조 파일을 찾는 것”이 아니라 “초안 작성 루프를 이해하고 깔끔하게 적용하는 것”입니다.

writing-shape 스킬 FAQ

writing-shape은 markdown 입력에만 쓰나요?

기본적으로 markdown 파일을 중심으로 설계됐지만, “덩어리”는 markdown으로 변환된 녹취, 메모, 거친 초안일 수도 있습니다. 핵심은, 다듬기 시작하기 전에 소스가 하나의 완결된 자료 묶음으로 읽혀야 한다는 점입니다.

일반 프롬프트와 뭐가 다른가요?

일반 프롬프트는 완성본 초안을 한 번에 요청하는 경우가 많습니다. writing-shape은 반복적인 편집 세션을 안내합니다. 도입부 선택, 문단 순서, 형식에 대한 논의가 작업 중간에 이뤄지기 때문에, 산만한 입력에서도 더 의도적인 글을 만들기 쉽습니다.

writing-shape은 초보자에게도 좋은가요?

네, 사용자가 원자료를 제공하고 몇 가지 편집 질문에 답할 수 있다면 그렇습니다. 특히 초보자가 “무엇이 있는지”는 알지만, 그것을 어떻게 설득력 있는 글로 조직해야 하는지는 아직 감을 잡지 못했을 때 도움이 큽니다.

언제는 쓰지 말아야 하나요?

이미 구조가 촘촘한 콘텐츠, 다듬을 만한 원본 덩어리가 없는 경우, 또는 발전형 글이 아니라 한 번에 끝나는 요약이 필요한 경우에는 writing-shape을 쓰지 않는 편이 좋습니다. 가장 가치가 큰 시점은 단순 정리가 아니라 “어떤 형태로 만들지”를 결정해야 할 때입니다.

writing-shape 스킬 개선 방법

더 선명한 편집 브리프를 주세요

writing-shape에서 가장 좋은 결과는 분명한 약속에서 나옵니다. 이 글이 누구를 위한 것인지, 어떤 문제를 푸는지, 어떤 종류의 글이 되어야 하는지 명확해야 합니다. 처음에 독자와 결과물을 짚어 주면, 스킬이 더 나은 도입부를 고르고 뒤의 문단도 그에 맞게 맞춰 나갈 수 있습니다.

더 좋은 원본 자료를 넣으세요

흔한 실패 원인은 원본 덩어리가 너무 넓거나, 반복적이거나, 무관한 리서치가 섞여 있는 경우입니다. 스킬을 실행하기 전에 불필요한 잡음을 줄이고, 가장 관련 높은 markdown 조각을 함께 묶고, 여러 주제가 섞여 있다면 섹션을 라벨링하세요. 입력이 좋아질수록 분기 많은 초안이 줄고, 구조를 잡는 대화도 더 명확해집니다.

문장만이 아니라 구조를 반복해서 다듬으세요

첫 초안이 어색하다면 “더 나은 문장”만 요청하지 마세요. 대신 논지를 조정하고, 전개의 순서를 바꾸고, 글의 형식 기대치를 바꿔 보세요. writing-shape은 문장보다 먼저 글의 모양을 고칠 때 가장 크게 좋아집니다.

글 파일은 그대로 유지하세요

이 스킬은 매번 작성 전에 글 문서를 다시 읽는 것을 전제로 하므로, 수정은 채팅에서 흩어져 처리하기보다 해당 파일에 남겨 두는 편이 좋습니다. 그렇게 하면 사용자의 변경 사항을 안전하게 지킬 수 있고, 협업도 더 안전해지며, writing-shape을 긴 초안 작업에도 계속 유용하게 쓸 수 있습니다.