에이전트 스킬 빌더

브라우저에서 Markdown 초안을 Claude 또는 Codex SKILL.md 파일로 정리하세요.

스킬 빌더 워크벤치
생성된 SKILL.md
프런트매터 준비됨 본문 준비됨
SKILL.md 파일이란?

에이전트 스킬은 코딩 에이전트에게 특정 유형의 작업을 처리하는 방법을 알려주는 SKILL.md 파일이 담긴 폴더입니다. 파일은 name과 description을 담은 YAML frontmatter로 시작하고, 그 뒤에 Markdown 지시문이 이어집니다. 에이전트는 description을 읽고 언제 이 스킬을 쓸지 판단하므로, 그 한 줄이 스킬이 쓰일지 말지를 좌우합니다.

빌더 동작 방식

Markdown 초안을 붙여 넣거나 직접 쓰면, 빌더가 이 브라우저 탭 안에서 유효한 스킬 파일로 다시 씁니다. 초안에 이미 있던 frontmatter는 새 블록을 쓰기 전에 제거되고, 줄바꿈 문자와 반복된 빈 줄이 정리되며, 초안에 H1이 있으면 첫 번째 H1이 표시 제목이 됩니다. 결과물은 고정된 형식의 YAML frontmatter와 제목, 그리고 When to Use·Instructions 섹션입니다.

주요 사용 사례
  • 거친 Markdown 노트에서 새 Claude 또는 Codex 스킬 초안 작성
  • SKILL.md 파일로 저장하기 전에 기존 프런트매터 정리
  • AI API를 호출하지 않고 브라우저 로컬 스킬 핸드오프 준비
  • 런북이나 사고 대응 체크리스트를 에이전트가 스스로 골라 쓰는 스킬로 전환
  • 에이전트가 한 번도 실행하지 않는 스킬을, 작업이 아니라 상황을 설명하도록 다시 작성
빌더가 보장하는 것
  • 에이전트가 판단 기준으로 삼는 name과 description을 담은 고정 형식 YAML frontmatter
  • 새 블록을 넣기 전에 기존 frontmatter 제거
  • 줄바꿈 문자 통일과 반복된 빈 줄 정리
  • 생성되는 모든 파일에 제목과 When to Use·Instructions 섹션 포함
  • 외부 AI API 호출 없이 이 브라우저 탭에서만 이루어지는 정리 작업
예시
입력: # Quick Triage Helper
출력: name: quick-triage-helper
입력: --- title: old ---
출력: 기존 frontmatter 제거, 새 name과 description 작성
입력: ~/.claude/skills/quick-triage-helper/SKILL.md
출력: 개인 스킬로 쓸 때 생성된 파일을 저장할 위치
자주 묻는 질문

생성된 파일은 어디에 두나요?

스킬 이름으로 만든 폴더 안에 SKILL.md로 저장하세요. 개인 스킬은 ~/.claude/skills/<name>/SKILL.md, 저장소 전체가 공유하려면 프로젝트 안의 .claude/skills/<name>/SKILL.md 에 둡니다.

에이전트가 스킬을 고르게 만드는 좋은 description이란?

기능이 아니라 이 스킬을 불러야 할 상황을 적으세요. 제목을 되풀이하는 설명보다, 언제 쓰는지로 시작하는 설명이 낫습니다. 에이전트는 눈앞의 작업과 description을 대조하기 때문입니다.

제 초안이 브라우저 밖으로 나가나요?

아닙니다. 정리와 frontmatter 생성은 이 탭에서 이루어지고, AI API는 호출되지 않습니다. 여러분이 결과물을 직접 어딘가로 복사하지 않는 한 아무것도 업로드되지 않습니다.

Claude 이외의 에이전트에서도 쓸 수 있나요?

결과물은 YAML frontmatter가 붙은 일반 Markdown이므로, 폴더에서 스킬 파일을 읽는 에이전트라면 어느 것이든 사용할 수 있습니다. 도구마다 다른 것은 설치 경로뿐입니다.

생성한 뒤에도 계속 수정할 수 있나요?

네. 결과물은 출발점입니다. Instructions 섹션은 자유롭게 고치고, frontmatter를 다시 써야 할 때마다 초안을 빌더에 한 번 더 통과시키면 됩니다.