marp-slide

marp-slide 스킬 개요

marp-slide가 하는 일

marp-slide 스킬은 대략적인 발표 요청을 완성도 있는 Marp 슬라이드 덱으로 빠르게 정리해 주는 데 특화되어 있습니다. 미리 준비된 테마, 슬라이드 구조 가이드, Marp 전용 문법 레퍼런스를 활용해 단순히 “슬라이드 써줘” 수준의 일반적인 답변이 아니라, 실제로 바로 다듬어 쓸 수 있는 slide markdown을 만드는 데 강합니다.

marp-slide를 써야 하는 사람

다음에 해당하면 marp-slide를 쓰는 편이 좋습니다:

• 메모, 아웃라인, 회의 내용으로 슬라이드 덱을 자주 만든다
• PowerPoint 전용 결과물보다 Marp 호환 markdown이 필요하다
• CSS를 손으로 직접 설계하지 않고도 시각적 일관성을 높이고 싶다
• 에이전트에게 “보기 좋게 만들어줘”라고 자주 요청하는데, 그 요청을 실제 작업 흐름에 맞게 구체화하고 싶다

marp-slide의 가장 잘 맞는 작업

핵심 작업은 단순히 “불릿 생성”이 아닙니다. 적절한 테마를 고르고, 발표하기 좋은 구조로 슬라이드를 짜고, 거의 바로 렌더링 가능한 수준의 Marp markdown을 만드는 것입니다. Marp 문법, 이미지 배치 패턴, 테마 스타일링을 일일이 찾아보지 않고도 아이디어에서 덱까지 빠르게 가야 할 때 특히 가치가 큽니다.

marp-slide가 일반 프롬프트와 다른 점

일반적인 프롬프트와 비교했을 때 marp-slide는 다음을 제공합니다:

• 7가지 기본 시각 방향: default, minimal, colorful, dark, gradient, tech, business
• assets/ 안의 재사용 가능한 템플릿 파일
• Marp 문법, 이미지 레이아웃, 테마 선택, 고급 기능, CSS 커스터마이징을 위한 레퍼런스 문서
• “전문적으로 보이게”, “좀 더 멋지게”처럼 모호한 요청도 실제 제작 흐름으로 풀어내는 작업 방식

설치 전에 사용자가 가장 궁금해하는 점

도입 전에 보통 확인하는 질문은 명확합니다:

• 처음부터 프롬프트를 짜는 것보다 시간을 아껴 주나? Marp 결과물이 필요하다면 대체로 그렇습니다.
• 유연한가? 테마 선택과 초안 작성에는 충분히 유연하지만, 브랜드 시스템을 아주 세밀하게 맞추려면 한계가 있습니다.
• 초보자도 쓰기 쉬운가? 대체로 그렇습니다. 템플릿과 레퍼런스 덕분에 Marp를 감으로 맞출 일이 줄어듭니다.
• 모든 발표 형식에 맞나? 아닙니다. 목표 형식이 Marp markdown일 때 가장 강합니다.

marp-slide 스킬 사용 방법

marp-slide 설치 맥락

에이전트 환경이 Skills 설치를 지원한다면, 일반적인 툴킷 패턴은 다음과 같습니다:

npx skills add softaworks/agent-toolkit --skill marp-slide

현재 사용 중인 환경이 이 설치 방식을 쓰지 않는다면, 리포지토리에서 skills/marp-slide 폴더를 직접 열어 해당 파일들을 작업 기준으로 삼으면 됩니다. 중요한 점은 marp-slide가 SKILL.md뿐 아니라 assets/와 references/ 파일까지 함께 읽을 수 있을 때 가장 유용하다는 것입니다.

먼저 읽어야 할 파일

가장 빠르게 익히려면 다음 순서로 읽는 것이 좋습니다:

1. SKILL.md
2. references/marp-syntax.md
3. references/theme-selection.md
4. 현재 용도와 맞는 assets/template-*.md
5. 시각 자료가 중요하다면 references/image-patterns.md
6. 커스터마이징이 필요하다면 references/advanced-features.md와 references/theme-css-guide.md

이 순서가 리포지토리를 불필요하게 뒤지지 않으면서도 가장 큰 정보 이득을 줍니다.

marp-slide에 필요한 입력

marp-slide는 다음 정보가 있을 때 가장 잘 작동합니다:

• 청중: executives, students, engineers, customers
• 목표: persuade, explain, teach, report status
• 덱 길이: 목표 슬라이드 수 또는 발표 시간 제한
• 원본 자료: notes, bullets, doc excerpt, meeting summary
• 톤: formal, technical, minimal, energetic
• 시각적 선호: theme, light/dark, image-heavy vs text-light
• 출력 제약: pure Marp markdown, speaker notes 포함 여부

그냥 “슬라이드 덱 만들어줘”라고만 말해도 초안은 만들 수 있지만, 테마 선택과 슬라이드 밀도는 추정에 의존하게 됩니다.

거친 요청을 강한 marp-slide 프롬프트로 바꾸기

약한 프롬프트:

• “Create slides about our API migration.”

더 강한 프롬프트:

• “Use marp-slide to create a 10-slide Marp deck for engineering managers about our API migration. Audience knows the old system but not the rollout plan. Use the tech theme, keep slides concise, include one architecture slide, one risk slide, and one migration timeline slide. Optimize for a 12-minute internal presentation.”

이 정도로 주면 스킬이 구조, 정보 밀도, 테마를 훨씬 정확하게 선택할 수 있습니다.

결과물에 실제로 영향을 주는 테마 선택

대부분의 사용자가 생각하는 것보다 테마 선택은 가독성과 적합성에 큰 영향을 줍니다:

• tech: 엔지니어링, 제품 아키텍처, 개발자 발표
• business: 분기 리뷰, 제안서, 대외용에 가까운 내부 보고
• minimal: 학술 발표, 워크숍, 문서형 덱
• colorful 또는 gradient: 이벤트, 크리에이티브, 프로모션, 가벼운 톤
• dark: 어두운 공간에서의 발표, 혹은 강한 시각 대비가 필요할 때
• default: 브리프가 넓거나 애매할 때 무난한 선택

스타일 언어 자체에 큰 관심이 없다면, 개인 취향보다 청중 기준으로 고르는 편이 낫습니다.

빈 덱에서 시작하지 말고 템플릿부터 쓰기

실전에서는 assets/에서 가장 가까운 템플릿을 먼저 열고 수정하는 방식이 효율적입니다:

• assets/template-business.md
• assets/template-tech.md
• assets/template-minimal.md
• assets/template-dark.md
• assets/template-colorful.md
• assets/template-gradient.md
• assets/template-basic.md

에이전트에게 서식을 처음부터 발명하게 하는 것보다 이 방식이 낫습니다. 이 템플릿들에는 이미 레이아웃, 타이포그래피, 여백에 대한 판단이 반영되어 있기 때문입니다.

실제 슬라이드 제작에 맞는 권장 워크플로우

안정적으로 쓰려면 다음 흐름이 좋습니다:

1. 테마를 고른다
2. 메시지와 청중을 추출한다
3. 먼저 슬라이드 아웃라인을 만든다
4. 각 슬라이드를 Marp markdown으로 확장한다
5. 설명에 도움이 되는 곳에만 이미지나 다이어그램을 넣는다
6. 렌더링해 보고 텍스트가 많은 슬라이드를 줄인다
7. 덱의 구조가 이미 괜찮을 때만 CSS를 손본다

이 순서를 지키면 흔한 실패 패턴, 즉 슬라이드 논리가 잡히기 전에 스타일링에 시간을 쓰는 문제를 피할 수 있습니다.

덱 품질을 확실히 끌어올리는 팁

더 나은 marp-slide 결과를 원한다면:

• 브리프가 지저분할수록 전체 본문보다 먼저 슬라이드 아웃라인을 요청하세요
• 발표용 덱을 원하면 “슬라이드당 3–5 bullets max”처럼 명시하세요
• 텍스트 위주인지 말고, 어떤 슬라이드를 비주얼 중심으로 만들지 알려 주세요
• 필요하다면 타이틀 슬라이드와 마무리 슬라이드를 명시적으로 요청하세요
• 발표 시간을 꼭 주세요. 슬라이드 수와 정보 밀도에 큰 영향을 줍니다

이런 입력이 “전문적으로 해줘” 같은 포괄적 표현보다 초안 품질에 훨씬 더 직접적으로 작용합니다.

Marp 레퍼런스를 언제 봐야 하나

이 레퍼런스들은 단순 배경 설명이 아니라, 자주 막히는 지점을 해결해 줍니다:

• references/marp-syntax.md: 기본 작성법과 directives
• references/image-patterns.md: 이미지 배치와 공식 Marpit 패턴
• references/best-practices.md: 슬라이드 밀도와 구조
• references/advanced-features.md: 더 풍부한 레이아웃과 효과
• references/theme-css-guide.md: custom CSS 변경
• references/official-themes.md: 더 넓은 Marp 테마 맥락

plain markdown으로 읽기만 좋은 결과가 아니라, 실제로 깔끔하게 렌더링되는 결과가 필요할 때 참고하면 됩니다.

marp-slide 사용 예시 프롬프트

다음과 같은 프롬프트로 스킬을 호출할 수 있습니다:

“Use marp-slide to create a Marp deck from these notes. Audience: startup investors. Goal: explain product traction and funding use. Length: 8 slides. Theme: business. Include a strong lead slide, one market slide, one traction slide, one roadmap slide, and a closing ask. Keep each slide presentation-friendly, not document-heavy.”

이 정도면 스킬의 장점을 살리기에 충분히 구체적이면서도, 초안을 과하게 옥죄지는 않습니다.

marp-slide 스킬 FAQ

marp-slide는 일반적인 슬라이드 작성 프롬프트보다 낫나?

Marp 결과물이 필요하다면 대체로 그렇습니다. 일반 프롬프트도 그럴듯한 슬라이드 텍스트는 만들 수 있지만, marp-slide는 테마 선택, 재사용 가능한 템플릿, Marp 전용 포맷 레퍼런스, 그리고 더 견고한 기본 워크플로우를 함께 제공합니다.

marp-slide는 개발자만 쓰는 도구인가?

아닙니다. 이 리포지토리에는 business, academic, creative 용도에 맞는 테마도 포함되어 있습니다. 기반 기술은 Marp처럼 markdown 중심이라 다소 기술적으로 보일 수 있지만, 실제 활용 범위는 개발자 발표보다 훨씬 넓습니다.

초보자도 marp-slide 스킬을 쓸 수 있나?

그렇습니다. 특히 템플릿을 따라가면 훨씬 쉽습니다. 가장 쉬운 경로는 가까운 테마를 고르고, 청중과 목표를 주고, 짧은 덱 초안을 에이전트에게 맡기는 방식입니다. Marp를 깊이 알아야만 가치를 얻는 도구는 아닙니다.

marp-slide가 잘 맞지 않는 경우는 언제인가?

다음 조건이라면 marp-slide는 건너뛰는 편이 낫습니다:

• 수동 애니메이션이 많은 PowerPoint 중심 워크플로우가 필요하다
• 여기 포함된 범위를 넘어서는 기업 전용 템플릿 수준의 브랜드 준수가 필요하다
• 결과물이 사실상 슬라이드 덱이 아니라 긴 보고서에 가깝다
• Marp나 markdown을 전혀 쓸 계획이 없다

marp-slide는 커스텀 스타일링도 다뤄 주나?

어느 정도는 가능합니다. 기본 제공 CSS 테마만으로도 커버 범위가 넓고, references/theme-css-guide.md가 수정 작업에 도움을 줍니다. 다만 완전히 bespoke한 디자인 시스템이 필요하다면, 기본 스킬만으로 끝나지 않고 추가 편집이 필요하다고 보는 편이 맞습니다.

marp-slide는 이미지 비중이 큰 덱에도 맞나?

맞습니다. 다만 이미지의 역할을 명확히 줬을 때에 한합니다. 이 스킬에는 references/image-patterns.md가 포함되어 있는데, Marp의 이미지 레이아웃은 문법에 민감하기 때문에 이 부분이 중요합니다. 비주얼이 핵심이라면 어떤 슬라이드에 이미지를 넣을지, 그리고 그 이미지가 어떤 역할을 해야 하는지를 함께 지정하세요.

marp-slide 스킬을 더 잘 활용하는 방법

더 좋은 원본 자료를 주기

marp-slide 품질을 가장 크게 끌어올리는 요소는 화려한 수식어가 아니라 입력 자료의 질입니다. 좋은 원본 입력의 예시는 다음과 같습니다:

• 우선순위가 보이는 러프한 아웃라인
• 주제별로 묶인 raw notes
• 압축해야 할 문서 섹션
• 원하는 슬라이드 수와 발표 시간
• 참고하고 싶은 덱 예시

정리되지 않은 자료를 한꺼번에 던지면, 에이전트는 서사를 추측해서 메워야 합니다.

청중과 기대하는 의사결정 결과를 분명히 하기

좋은 marp-slide 브리프는 덱을 본 뒤 청중이 무엇을 이해하거나 어떤 행동을 해야 하는지까지 담고 있습니다. 예를 들면:

• 마이그레이션 계획을 승인한다
• 연구 결과를 이해한다
• 여러 옵션 중 하나를 선택한다
• 교육 포인트를 기억한다

이 정보가 있어야 에이전트가 어떤 내용은 슬라이드로 살리고, 어떤 내용은 덜어내야 하는지 판단할 수 있습니다.

텍스트가 과한 초안을 막기

가장 흔한 실패 패턴 중 하나는 슬라이드에 내용이 너무 많이 들어가는 것입니다. marp-slide 결과를 개선하려면 다음을 요청하세요:

• 슬라이드당 bullet 수를 줄이기
• 제목을 더 짧게 쓰기
• 빽빽한 주제는 두 장으로 나누기
• 슬라이드당 메시지 하나만 남기기
• 문서형 문장보다 발표자 친화적 표현 쓰기

특히 원본 자료가 메모나 회의록, transcript일 때 이 점이 더 중요합니다.

CSS를 만지기 전에 맞는 템플릿부터 고르기

사용자들은 종종 테마 CSS부터 너무 일찍 건드립니다. 더 나은 방식은 다음과 같습니다:

1. 가장 가까운 템플릿을 고른다
2. 구조와 가독성을 먼저 검증한다
3. 필요하면 그다음에 색상, 여백, 타이포그래피를 조정한다

덱의 구조가 약하면 CSS를 바꿔도 근본적인 문제는 해결되지 않습니다.

구체적인 수정 요청으로 반복 개선하기

첫 초안 이후에는 “이거 더 좋게 해줘”만 남기지 않는 것이 좋습니다. 더 나은 수정 프롬프트 예시는 다음과 같습니다:

• “Reduce slide 4 to three bullets and add a clearer takeaway.”
• “Convert slides 5 and 6 into a problem/solution pair.”
• “Switch from default to business and tighten the tone for executives.”
• “Add one image-friendly slide using Marp-compatible layout patterns.”

이처럼 지점이 명확한 수정 요청이, 광범위한 스타일 요청보다 두 번째 결과물을 훨씬 좋게 만듭니다.

리포지토리 레퍼런스를 품질 체크리스트처럼 활용하기

marp-slide 결과를 개선하는 실용적인 방법은 레퍼런스 파일을 초안 작성 후 점검표처럼 쓰는 것입니다:

• syntax validity: references/marp-syntax.md
• image correctness: references/image-patterns.md
• design polish: references/best-practices.md
• deeper customization: references/advanced-features.md and references/theme-css-guide.md

이렇게 하면 이 스킬은 일회성 프롬프트가 아니라, 반복 가능한 슬라이드 제작 워크플로우가 됩니다.

marp-slide의 핵심 트레이드오프 이해하기

marp-slide의 강점은 신뢰할 만한 Marp 덱을 빠르게 만드는 데 있습니다. 반대로 tradeoff는 Marp 구조와 기본 제공 테마 중심으로 어느 정도 방향성이 정해져 있다는 점입니다. 픽셀 단위까지 맞춘 bespoke 발표 디자인이 필요하다면, 이 스킬은 빠른 초안과 구조 설계용으로 쓰고 그 이후에 추가 커스터마이징하는 쪽이 현실적입니다. 첫 결과물부터 최종 브랜드 완성도를 기대하는 용도와는 조금 다릅니다.