설정과 멀티 파일 스킬

A basic skill works with just a name and description, but here are some other advanced tips that can make your skills really effective in claw code. 기본 skill은 이름과 description만으로 작동하지만, Claude Code에서 skill을 훨씬 효과적으로 만드는 고급 팁이 몇 가지 더 있습니다. The agentskills.io open standard has many available fields. agentskills.io open standard에는 다양한 필드가 있습니다. We already went over the name, which identifies your skill, uses lowercase letters, numbers, and hyphens only. name 필드는 이미 다뤘습니다. skill을 식별하며 소문자, 숫자, 하이픈만 사용합니다. A maximum of 64 characters and should match your directory name. 최대 64자이며 디렉터리 이름과 일치해야 합니다. a description which is also required which tells Claude when to use the skill. description도 필수 항목으로, Claude에게 skill을 언제 사용할지 알려줍니다. This is a maximum of,024 characters and is the most important field. 최대 1,024자이며 가장 중요한 필드입니다. Claude uses this for matching. Claude는 이것을 매칭에 사용합니다. But we can also add other optional fields. 다른 선택적 필드도 추가할 수 있습니다. One of them is the allowed tools field which restricts which tools Claude can use when the skill is active. 그 중 하나는 allowed tools 필드로, skill이 활성화될 때 Claude가 사용할 수 있는 도구를 제한합니다. The model field which specifies which cla model to use for the skill. model 필드는 skill에 사용할 Claude 모델을 지정합니다. Try to be explicit with your instructions. 지침을 명확하게 작성하세요. For example, if someone told me my job was to help with dogs, I wouldn't know what to do. 예를 들어, 누군가 제 일이 개를 돕는 것이라고 말한다면 저는 무엇을 해야 할지 모를 것입니다. So, we have to assume Claude would think the same way. Claude도 같은 방식으로 생각한다고 봐야 합니다. A good description answers two questions. 좋은 description은 두 가지 질문에 답합니다. What does this skill do? 이 skill은 무엇을 하나요? And when should Claus use it? 그리고 Claude는 언제 사용해야 하나요? Now, if this job description was given to me, I feel a little bit more confident that I could get the job done. 이런 직무 설명이 주어진다면 일을 해낼 수 있다는 자신감이 훨씬 생깁니다. If your skill isn't triggering, add more keywords that match how you phrase requests. skill이 트리거되지 않는다면, 요청을 표현하는 방식과 일치하는 키워드를 더 추가하세요. Sometimes you want a skill that can only read files, not modify them. 파일을 읽기만 하고 수정은 할 수 없는 skill이 필요할 때가 있습니다. This could be for security sensitive workflows, read only tasks or more. 보안에 민감한 워크플로, 읽기 전용 작업 등에 활용할 수 있습니다. We have the allowed tools field to make this possible. 이를 가능하게 하는 것이 allowed tools 필드입니다. When this skill is active, Claw can only use those tools without asking permission. 이 skill이 활성화되면 Claude는 권한 요청 없이 해당 도구만 사용할 수 있습니다. No editing, no writing, no bash commands. 편집도, 쓰기도, bash 명령도 사용하지 않습니다. If you omit allowed tools, the skill doesn't restrict anything. allowed tools를 생략하면 skill은 아무것도 제한하지 않습니다. Claude uses its normal permission model. Claude는 기본 권한 모델을 사용합니다. Skills share Claw's context window with your conversation. Skills는 대화와 함께 Claude의 컨텍스트 윈도우를 공유합니다. When Claude wants to use a skill, it will decide to load the contents of that skill into context. Claude가 skill을 사용하려 할 때, 해당 skill의 내용을 컨텍스트에 불러올지 결정합니다. However, sometimes you'll need some references, examples, or some utility scripts that are required by the skill. 하지만 때로는 skill에 필요한 참조 자료, 예시, 유틸리티 스크립트가 필요할 수 있습니다. But cramming it all into one 20,000 line text file means you take up a lot of space in the context window. 이 모든 것을 20,000줄짜리 텍스트 파일 하나에 넣으면 컨텍스트 윈도우를 많이 차지하게 됩니다. And let's be real here, it's just not a lot of fun to maintain that. 솔직히 말해서, 그걸 유지 관리하는 건 전혀 즐겁지 않습니다. This is where progressive disclosure comes in. 여기서 단계적 공개가 등장합니다. Put your essential instructions in skill.mmp and detailed reference material in separate files that Claude reads only when needed. 핵심 지침은 skill.md에 넣고, 상세 참조 자료는 Claude가 필요할 때만 읽는 별도 파일에 보관하세요. The open standard also suggests having a scripts folder for executable code, references for additional documentation and assets for images, templates or other data files that would be relevant for that skill. open standard는 실행 가능한 코드를 위한 scripts 폴더, 추가 문서를 위한 references, 해당 skill과 관련된 이미지·템플릿·데이터 파일을 위한 assets 폴더를 갖출 것도 권장합니다. Then in skill.md link to the supporting files. 그런 다음 skill.md에서 지원 파일로 링크를 연결하세요. Here, Claude reads architecture.md only when someone asks about system design. 여기서 Claude는 누군가 시스템 설계에 대해 물을 때만 architecture.md를 읽습니다. If they're asking where to add a component, let's say, it just never loads. 컴포넌트를 어디에 추가할지 묻는다면, 예를 들어, 그 파일은 아예 로드되지 않습니다. It's like having a table of contents in the context window rather than fitting the whole entire document in there. 전체 문서를 컨텍스트 윈도우에 넣는 대신 목차만 두는 것과 같습니다. Keep skill.md under 500 lines. skill.md는 500줄 미만으로 유지하세요. If you're exceeding that, then maybe consider should this be split up into different content. 그것을 초과하고 있다면, 내용을 분리할지 고민해 보세요. Scripts in your skill directory can run without loading their contents into context. skill 디렉터리의 스크립트는 내용을 컨텍스트에 불러오지 않고도 실행할 수 있습니다. The script executes and only the output consumes tokens. 스크립트가 실행되고, 출력 결과만 토큰을 소비합니다. Tell claw to run the script, not read it. Claude에게 스크립트를 읽으라고 하지 말고 실행하라고 하세요. This is very useful for environment validation, data transformations that need to be consistent, operations that are more reliable as tested code than generated code. 이는 환경 검증, 일관성이 필요한 데이터 변환, 생성 코드보다 테스트된 코드로서 더 신뢰할 수 있는 작업에 매우 유용합니다. Skills support metadata fields. Skills는 메타데이터 필드를 지원합니다. Name and description which are required. 필수 항목은 name과 description 필드입니다. Allowed tools restricts available tools and model specifies which claw to use. allowed tools는 사용 가능한 도구를 제한하고, model은 사용할 Claude를 지정합니다. Descriptions need specific actions and trigger phrases to match for reliability. Descriptions는 안정적으로 매칭되려면 구체적인 동작과 트리거 문구가 필요합니다. For larger skills, use progressive disclosure. 대형 skill에는 단계적 공개를 활용하세요. Keep your skill.md file under 500 lines and link to the supporting files that load only when needed. skill.md 파일을 500줄 미만으로 유지하고, 필요할 때만 로드되는 지원 파일로 링크를 연결하세요. Scripts [music] can execute without loading their contents, keeping context efficient. 스크립트 [Music]는 내용을 불러오지 않고 실행되어 컨텍스트를 효율적으로 유지합니다.