skill-authoring
Q&A 정리: skill-authoring
Don't State the Obvious
AI는 이미 코딩에 대해 많이 알고 있으므로, 스킬에는 AI가 모르거나 평소와 다르게 생각해야 하는 정보만 담아야 한다. 이미 아는 내용을 반복하면 오히려 핵심이 묻힌다.
Claude Code knows a lot about your codebase, and Claude knows a lot about coding, including many default opinions. If you're publishing a skill that is primarily about knowledge, try to focus on information that pushes Claude out of its normal way of thinking.
Gotchas section
스킬에서 가장 가치 있는 부분은 "함정 모음(Gotchas)"이다. AI가 실제로 자주 실수하는 지점을 기록해 두는 것으로, 같은 실수를 반복하지 않도록 시간이 지나면서 계속 보강해야 한다.
The highest-signal content in any skill is the Gotchas section. These sections should be built up from common failure points that Claude runs into when using your skill. Ideally, you will update your skill over time to capture these gotchas.
Avoid Railroading
스킬 지시를 너무 구체적으로 쓰면 AI가 상황에 맞게 유연하게 대응하지 못한다. 필요한 정보는 주되, AI가 스스로 판단할 여지를 남겨야 다양한 상황에서 재사용할 수 있다.
Claude will generally try to stick to your instructions, and because Skills are so reusable you'll want to be careful of being too specific in your instructions. Give Claude the information it needs, but give it the flexibility to adapt to the situation.
Skill setup pattern
스킬에 필요한 초기 설정 정보를 config.json 파일에 저장해 두면, 설정이 없을 때 AI가 사용자에게 자동으로 질문하여 필요한 정보를 수집할 수 있다.
A good pattern to do this is to store this setup information in a config.json file in the skill directory. If the config is not set up, the agent can then ask the user for information.