에이전트가 쓴 글을 직접 보여 주고, PDF도 만들게 하세요.

Claude Code에 설치하기

명령줄 도구 marsdawn가 스킬을 대신 써 주며, 써 주는 파일은 설치된 marsdawn 버전과 일치합니다. 아직 marsdawn가 없다면 Homebrew로 설치하세요.

brew install redtear1115/tap/marsdawn

그런 다음 스킬을 설치합니다.

marsdawn skill --install

이 명령은 ~/.claude/skills/marsdawn/SKILL.md를 쓰고, 폴더가 없으면 만듭니다. 파일은 설치된 marsdawn에서 나오므로, 그 버전에 없는 옵션이 적히는 일은 없습니다.

Claude Code는 PDF가 필요한 작업일 때, 또는 여러분이 읽을 Markdown 문서를 쓰거나 고쳤을 때 이 스킬을 불러옵니다. /marsdawn으로 직접 실행할 수도 있습니다. 먼저 내용을 읽어 보고 싶다면 짧은 파일 하나입니다.

marsdawn을 업그레이드한 뒤

Homebrew는 marsdawn를 업그레이드하지만 스킬은 그대로 두므로, 새로 고치기 전까지 예전 버전으로 남아 있습니다.

marsdawn skill --install --force

--force는 기존 SKILL.md를, 직접 고친 부분까지 포함해 교체합니다. --force 없이 실행하면, 내용이 다른 SKILL.md가 이미 있을 때 marsdawn는 그 파일을 건드리지 않고 내용이 다르다고 알려 준 뒤 코드 64(skill_differs)로 종료합니다. 파일이 이미 최신이면 아무것도 바뀌지 않습니다.

다른 에이전트의 경우

--dir에 에이전트가 스킬을 두는 폴더를 지정하면 marsdawn가 SKILL.md를 그곳에 씁니다.

marsdawn skill --install --dir <path>

이 파일은 지침과 명령으로 된 일반 Markdown이므로, 지침 파일을 불러오는 에이전트라면 그대로 쓸 수 있습니다.

Homebrew나 명령줄 도구가 없는 경우

먼저 marsdawn를 설치할 수 없다면 파일을 직접 내려받으세요.

mkdir -p ~/.claude/skills/marsdawn
curl -fsSL https://marsdawn.southern-light.dev/cli/skill/SKILL.md -o ~/.claude/skills/marsdawn/SKILL.md

이 방법은 이 사이트의 최신 스킬을 가져오므로, 오래된 marsdawn보다 앞서 있을 수 있습니다. 도구를 설치한 뒤에는 marsdawn skill --install --force로 거기에 맞는 것으로 교체할 수 있습니다. 에이전트에게 이 URL을 알려 주거나 파일을 붙여 넣어도 됩니다.

가르치는 내용

• marsdawn이 없으면 Homebrew로 설치하고, 버전을 짐작하지 말고 marsdawn --version으로 확인하기.
• marsdawn export … --json으로 내보내고 결과 읽기: PDF가 저장된 위치, 페이지 수, 렌더링되지 않은 Mermaid 다이어그램.
• 종료 코드로 실패를 구분하기: 파일 없음, PDF가 이미 있음, 내보내기 실패, 잘못된 옵션.
• 자신이 쓴 문서를 marsdawn open file.md:line으로 첫 번째 변경 위치에서, 한 번만 열기. 이후의 편집은 열린 윈도우에 알아서 반영됩니다.
• MarsDawn 앱이 설치되어 있지 않으면 한 번만 알리고, 다시 시도하지 말고 계속 진행하기. PDF를 만들 때 open은 절대 쓰지 않기.
• --folder(marsdawn 0.5.1 이상)를 쓸 때는 폴더를 표시됨이 아니라 요청됨으로 보고하기. 앱이 결정하고, 결과를 알려 주는 것은 없습니다.

하지 않는 일

• 스스로에게 실행 권한을 주지 않습니다. 에이전트는 다른 명령과 마찬가지로 marsdawn을 설치하거나 실행하기 전에 여전히 묻습니다.
• 문서를 어디에도 보내지 않습니다. marsdawn은 여러분의 Mac에서 렌더링하며, --allow-remote-images를 주지 않으면 웹 이미지를 빼고 렌더링합니다.

모든 필드와 코드를 포함한 전체 규약은 에이전트를 위한 marsdawn에 있습니다. 스킬 파일을 읽는 대신 MCP로 도구를 호출하는 에이전트라면 MCP 서버도 있습니다.