본문 바로가기

  • 교재 소개

  • 10장 종합 프로젝트와 자료실

  • 10.3 용어와 공식 참고 문서

용어와 공식 참고 문서

1. 용어를 작업과 연결하기

용어이 책에서의 의미
Skill반복 업무 지침과 관련 파일의 묶음
SKILL.mdSkill의 메타데이터와 본문 지침
frontmatter파일 맨 앞 YAML 메타데이터
description수행 내용과 사용 상황 설명
점진적 로딩필요한 수준의 자료를 단계적으로 읽는 방식
references필요한 때 읽는 세부 규칙·근거
assets결과에 사용할 서식·정적 자원
scripts재현 가능한 실행 코드
RFP제안 요청 문서
요구사항 대응표요구·본문·근거·상태의 연결표
회귀 확인수정 뒤 기존 사례가 여전히 맞는지 검사
기준 예시결과를 비교하기 위해 제공하는 참고 산출물

기능 이름보다 “무엇을 어디서 확인하는가”를 기억하세요. 만족도 계산이 틀리면 디자인 템플릿이 아니라 지표 정의와 집계 스크립트를 봅니다.

1.1 공식 문서

제품 안내는 2026년 9월 7일 확인 기준이며 이후 바뀔 수 있습니다.

1.2 제품별 필드는 구분해서 사용하기

인터넷 예시에 나오는 YAML 필드를 모두 넣을 필요는 없습니다. 이 책의 샘플은 공통 필드인 name과 description을 기본으로 하고, 코드가 필요한 두 Skill에만 compatibility로 실행 조건을 적었습니다.

Claude Code에는 자동 호출을 막는 disable-model-invocation 같은 확장 필드가 있습니다. 이런 필드는 대상 환경의 공식 문서를 확인한 뒤에 써야 하고, 다른 앱에서도 같은 뜻으로 통한다고 가정하면 안 됩니다. 이 책의 샘플은 자동 선택을 허용하며, 실제 발송과 제출 작업은 지침 범위에 넣지 않았습니다.

1.3 「위니브 Skill 모음」 교안과의 연결

이 책의 실습은 「Claude Desktop 에센셜」 독자에게 드리는 보너스 교안 「위니브 Skill 모음」의 Skill을 작게 옮긴 것입니다. 어느 실습이 어느 Skill에서 왔는지는 이렇습니다.

위니브 Skill이 책에서 연습한 곳
md-to-hwpx7장 Markdown·HTML·PDF와 HWPX
proposal-writer, public-bid-proposal5장 공고에서 요구사항 대응표 만들기
program-plan-proposal5장 운영 계획서 실습
program-result-report6장 전체
weniv-quote5장 견적 계산을 스크립트에 맡기기
html-slides7장 7장 발표와 3분 대본 만들기
instagram-card-news7장 모집 카드뉴스와 미정 정보 처리

작은 Skill을 직접 만들어 본 뒤 「위니브 Skill 모음」 교안으로 돌아가면, 서식과 자료가 많은 Skill에서도 같은 구조가 보일 것입니다.

1.4 다음 Skill을 만드는 질문

다음 업무에서는 네 가지를 먼저 적어보세요. 무엇이 반복되는가, 어떤 입력이 매번 바뀌는가, 어떤 부분은 계산으로 고정할 수 있는가, 무엇을 확인하면 완료인가. 이 네 줄이 4장의 다섯 칸 설계서와 이어지고, 그대로 SKILL.md 초안이 됩니다.

규칙을 많이 쌓는 것이 목적이 아닙니다. 다음번 같은 일을 할 때 설명을 덜 반복하고, 근거를 다시 찾기 쉽고, 사람이 결과를 판단할 수 있으면 됩니다.

용어와 공식 참고 문서 - Claude Skill 에센셜 | 위니버시티