스킬생성 후 업데이트.

Question

이번 강의에서 Next.js 16스킬을 예로 보여주셨고, 학습자료에 직접 만드신 스킬을 업로드 해주셨습니다. 버전이 높아지고, 가이드라인이 업데이트 될때 마다 reference도 업데이트가 되어야 될거 같은데, md파일에 해당페이지 링크를 업로드 해놓으면 안되는건가요? Reference파일이 17개를 처음부터 공식페이지랑 대조해가면서 보고 있는데, 짐코딩님은 레퍼런스 문서의 분류를 이렇게 나눈 이유가 있으신가요? 어떤식으로 나눠서 관리를 하면 좋을지 궁금합니다. 레퍼런스 가이드도 업데이트가 될텐데, 이런 업데이트 내용은 claude code에게 url던지고 파일 위치 알려준다음에 업데이트 하라고 하면 될까요?

communityai8509 · Answer

안녕하세요, 인프런 AI 인턴입니다. alsekfrwh님. 질문하신 내용과 가장 유사한 기존 답변을 아래 게시글에서 확인하실 수 있습니다. 스킬 작성 시 참고 섹션에 md가 아닌 웹 사이트도 가리킬 수 있나요? 가이드문서에 관하여 핵심 내용은 다음과 같습니다. Reference에 공식 문서 URL만 연결하는 방식보다는, 프로젝트에서 사용하는 버전에 맞는 내용을 md 파일로 고정해두는 방식이 권장 됩니다. 공식 문서는 계속 최신 버전으로 변경될 수 있기 때문에, 프로젝트가 Next.js 16을 사용한다면 Next.js 17 기준의 최신 문서가 아니라 현재 프로젝트 버전에 맞는 문서를 참고하는 것이 안전합니다. Reference 파일을 여러 개로 나누는 이유는 CLAUDE.md가 지나치게 길어지는 것을 방지하고, 필요한 상황에서 관련 문서만 선택적으로 참고하게 하기 위해서입니다. 예를 들어 Next.js 레이아웃, 데이터 패칭, 라우팅, 인증 등 주제별로 나누고, CLAUDE.md에는 각 문서의 경로만 연결하는 방식입니다. 처음부터 완벽하게 분류하기보다는 자주 참조하는 영역과 독립적인 주제를 기준으로 나눈 뒤, 실제 사용하면서 계속 정리하면 됩니다. 업데이트 시에는 Claude Code에 공식 문서 URL을 전달하고 해당 내용을 특정 Reference 파일에 반영해 달라고 요청할 수 있습니다. 다만 공식 문서 전체를 무조건 가져오기보다는 현재 프로젝트에서 필요한 부분만 선별하는 것이 좋습니다. 내용이 길거나 여러 페이지로 나뉘어 있다면 관련 문서를 파일로 저장한 뒤 @파일경로 로 전달하고, 프로젝트 버전에 맞게 요약·정리하도록 요청한 다음 결과를 직접 검토하는 흐름을 추천합니다. 즉, 다음과 같은 방식으로 관리할 수 있습니다. 1. 현재 프로젝트의 기술 스택과 버전 확인 2. 해당 버전에 맞는 공식 문서 중 필요한 주제만 선정 3. Claude Code로 Reference md 파일 생성 또는 수정 4. CLAUDE.md에는 Reference 파일 경로만 연결 5. 실제 개발 중 문제가 발생하거나 공식 문서가 변경되면 해당 파일을 다시 검토하고 업데이트 관련 답변에서는 공식 문서 내용을 프로젝트에 맞게 정리해 docs/guides 아래에 저장하고, 사용해 보면서 필요한 규칙을 반복적으로 보완하는 방법도 안내하고 있습니다. 저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.