init

init 스킬 개요

init 스킬이 하는 일

init은 저장소용 AGENTS.md 파일을 새로 만들거나 개선합니다. 목표는 코드베이스를 요약하는 것이 아니라, 에이전트가 저장소만 보고는 안정적으로 추론하기 어려운 몇 가지 지침을 담는 데 있습니다. 예를 들면 숨겨진 워크플로 선호도, 도구의 특이한 동작, 눈에 잘 띄지 않는 관례, 저장소별 함정 같은 내용입니다.

누가 사용해야 하나요

새 저장소에 AI 에이전트 지침을 세팅하거나, 지나치게 부풀려진 AGENTS.md를 정리하거나, 일반적인 프롬프트가 계속 놓치는 반복 실수를 바로잡고 있다면 init 스킬을 쓰면 좋습니다. 특히 Claude 설정을 하거나, 간결하고 저장소에 특화된 안내가 필요한 에이전트 워크플로를 운영하는 팀에 유용합니다.

무엇이 다른가

init 스킬은 “발견 가능성” 필터를 중심으로 설계되어 있습니다. 에이전트가 README, 코드, 설정 파일, 파일 구조만으로 배울 수 있는 내용이라면 AGENTS.md에 넣지 않아야 합니다. 그래서 결과물이 일반적인 “프로젝트 노트” 프롬프트보다 더 좁고, 더 실행 가능하게 나옵니다.

init 스킬 사용 방법

init 스킬 설치하기

먼저 스킬을 환경에 설치한 다음, 대상 저장소에 실행하세요. 일반적인 설치 예시는 다음과 같습니다:
npx skills add mcollina/skills --skill init

적절한 입력 주기

init 스킬은 저장소 경로 또는 명확한 대상, 그리고 실제로 조심해야 할 부분을 알아낼 수 있을 만큼의 맥락을 함께 줄 때 가장 잘 동작합니다. 좋은 입력에는 저장소의 실제 워크플로, 에이전트가 자주 저지르는 실수의 유형, 트리만 봐서는 드러나지 않는 제약이 포함됩니다.

올바른 파일부터 살펴보기

먼저 SKILL.md를 읽고, 그다음 README.md, AGENTS.md, metadata.json을 확인하세요. rules/, resources/, references/, scripts/ 폴더가 있다면 그것들도 살펴보면 좋습니다. 이 저장소는 파일 트리가 의도적으로 작기 때문에, 시작점은 주로 SKILL.md와 tile.json입니다.

거친 목표를 더 나은 프롬프트로 바꾸기

“AGENTS.md 하나 만들어 달라”라고만 요청하지 말고, 발견되지 않는 규칙만 담는 집중형 저장소 지침 파일을 만들라고 요청하세요. 예를 들어: “이 저장소용 최소한의 AGENTS.md를 만들되, 코드에서 추론할 수 없는 지침만 남기고 README나 설정과 중복되는 내용은 모두 제거해 달라”처럼 말할 수 있습니다.

init 스킬 FAQ

init 스킬은 어떤 문제를 해결하나요?

에이전트 지침이 너무 길어지거나, 너무 일반적이거나, 오래되어 버리는 흔한 실패를 해결합니다. init 스킬은 뻔한 저장소 사실을 반복하지 않으면서도 에이전트 동작을 개선하는 더 짧은 AGENTS.md를 만드는 데 도움을 줍니다.

init은 Skill Authoring용인가요, 아니면 일반 저장소 세팅용인가요?

주로 AGENTS.md를 중심으로 한 저장소 세팅과 유지보수에 쓰입니다. 스킬을 작성할 때도 같은 원칙이 도움이 되지만, 직접적인 역할은 코드베이스용 에이전트 지침을 생성하거나 정리하는 것입니다.

언제 init을 쓰지 말아야 하나요?

폭넓은 프로젝트 요약, 온보딩 가이드, 아키텍처 개요가 필요하다면 사용하지 마세요. 또 저장소에 숨은 워크플로 지식이 거의 없고, 대부분의 안내가 파일만 봐도 이미 분명하다면 적합하지 않습니다.

init 스킬을 개선하는 방법

구체적인 실패 사례를 알려주기

가장 좋은 init 사용법은 에이전트가 계속 틀리는 구체적인 사례를 포함하는 것입니다. 예를 들어 포맷 흔들림, 안전하지 않은 명령, 빌드 단계 누락, 잘못된 파일 대상 지정 같은 문제입니다. 실패 사례가 구체적일수록 AGENTS.md에 넣을 내용과 뺄 내용을 더 정확하게 가를 수 있습니다.

더 좋은 원천 자료 제공하기

더 높은 품질의 결과를 원한다면 실제 AGENTS.md, 최근의 README, 그리고 제약을 드러내는 CI나 도구 설정을 함께 주세요. 저장소가 이미 눈에 보이는 관례를 얼마나 잘 문서화하고 있느냐에 따라, init 스킬이 잡음을 걷어내고 핵심만 남기기 쉬워집니다.

발견 가능성 기준으로 검토하기

첫 번째 결과를 받은 뒤에는 각 줄을 발견 가능성 필터에 비춰 보세요. 에이전트가 저장소 자체에서 추론할 수 있는 내용인가요? 그렇다면 삭제하세요. 아니라면 작업 성공률, 비용, 안전성에 실제로 영향을 줄 때만 남기세요.

한 번 에이전트를 돌린 뒤 반복 개선하기

첫 번째 AGENTS.md는 초안으로 보세요. 에이전트가 같은 실수를 계속한다면, 그 실패를 정확히 겨냥한 짧은 한 줄만 추가하고 저장소 내용을 단순 반복하는 문장은 지우세요. init을 오래 유용하게 유지하는 가장 빠른 방법입니다.