대상 독자: Claude Code로 커스텀 스킬을 직접 제작하고 있으며, 그 스킬을 Zenn이나 Qiita에 소개하고 싶은 중급자

집필일: 2026-06-17

서론

Claude Code로 직접 만든 편리한 스킬, 로컬 환경에 그대로 잠들어 있지는 않나요?

사실 이 글을 쓰게 된 가장 큰 이유는 "다른 사람들이 어떤 식으로 Claude를 활용하고 있는지 더 알고 싶다!"라는 저 개인의 강한 바람 때문입니다.

매력적인 스킬이라도 기사 구성을 고민하거나, 코드 블록의 중첩 조정(4 백틱 문제)으로 고민하거나, 개인 경로(Path)나 API 키를 마스킹(Masking)하는 등의 "집필 수고" 때문에 세상에 나오지 못하는 것은 정말 아까운 일이죠.

그래서 발신의 허들을 극한까지 낮추기 위해, SKILL.md나 스크립트를 읽히는 것만으로 Zenn용 기사를 전자동으로 써 내려가는 「claude-skills-article」 스킬을 만들었습니다. 번거로운 작업은 모두 이 도구에 맡기고, 여러분의 소중한 스킬을 꼭 공유해 주세요!

스킬을 구성하는 요소

이 스킬을 구성하는 파일은 SKILL.md 뿐입니다 (scripts / assets 없음).

SKILL.md

스킬의 동작을 정의하는 지시 파일. Claude가 이 내용을 읽고 동작합니다.

SKILL.md

---
name: claude-skills-article
description: |
...

각 단계의 상세 해설

단계 0 — 대상 스킬의 특정

/claude-skills-article라고 부르는 것만으로는 스킬명을 특정할 수 없기 때문에, 미지정 시에는 사용자에게 확인합니다.

플랫폼도 마찬가지로, 명시되지 않은 경우에는 Zenn을 기본값으로 합니다.

단계 1 — 파일 수집

스킬 루트(~/.claude/skills/) 하위의 대상 스킬 디렉토리를 읽습니다.

SKILL.md는 필수이며, scripts/, assets/는 존재하는 것만 수집합니다.

단계 2 — 예상 독자 추정

SKILL.md의 내용으로부터 "누구에게 가장 도움이 될지"를 한 문장으로 추정합니다.

기사 서두에 게재하기 때문에, 독자가 "나를 위한 것이구나"라고 느끼는지 여부와 직결되는 중요한 단계입니다.

단계 3 — 마스킹 (Masking)

절대 경로(Absolute Path)나 API 키 등 공개해서는 안 되는 정보를 자동으로 치환합니다.

C:/Users/YourName/ → ~/.claude/skills/와 같은 변환을 수행하며, 커스터마이징이 필요한 부분에는 안내 코멘트를 추가합니다.

단계 4 — 기사 생성

7개 섹션 구성으로 기사 본문을 생성합니다.

접기 블록(Folding block) 표기법은 Zenn(:::details)과 Qiita(<details>)로 자동 전환합니다.

SKILL.md를 코드 블록에 담을 때의 백틱(Backtick) 개수 규칙이 독자적이어서, 내부 코드 블록의 최대 백틱 개수 + 1의 펜스(Fence)를 사용합니다
(통상적으로는 4 백틱, 이 스킬처럼 4 백틱 예시를 포함하는 경우에는 5 백틱).

단계 5 — 내보내기

works/article/zenn/ 또는 works/article/qiita/에 날짜가 붙은 파일명으로 저장합니다.

디렉토리가 존재하지 않는 경우 자동으로 생성합니다.

요약

설치 방법: ~/.claude/skills/claude-skills-article/SKILL.md에 배치하기만 하면 됩니다.

⚙ 이 경로는 독자의 환경에 맞춰 변경해 주세요.

처음 시도할 트리거 프레이즈(Trigger phrase):

• "setup 스킬의 기사를 써줘"
• "/claude-skills-article" → 대화를 통해 대상 스킬과 플랫폼을 선택

이 스킬은 아직 계속 개선 중입니다. "이런 기능이 있으면 좋겠다", "이 부분이 사용하기 불편하다" 등 개선안이나 피드백을 댓글로 알려주시면 감사하겠습니다!

Discussion