Skill 실행판의 Claude Code 적용 - Claude 대화

이 기록은 2026-09-30 DanzzaN과 Claude(Claude Code 데스크톱 Code 탭)의 대화에서 두 Skill 실행판을 Claude Code에 적용한 범위와 확인 결과를 보존한다. 결정의 배경과 Codex 적용은 Skill 중심 실행과 Vault 선택 조회 결정 - Codex 대화와 업무별 Skill 확장과 Vault 선택 조회 적용 - Codex 대화가 소유한다. 이 기록은 Claude Code의 파일·설정 적용만 다루며 claude.ai·Cowork 적용을 포함하지 않는다.

요청과 승인 범위

DanzzaN은 [비공개 문서]과 [비공개 문서]을 읽고 공통 본문을 유지한 채 등록 형식·호출 설정·진입 지침만 Claude에 맞추도록 요청했다. Claude가 설치 후보를 먼저 스테이징해 제시했고, DanzzaN은 세 가지 권장안을 승인했다. 적용 범위는 Claude Code(CLI와 데스크톱 Code 탭)로 한정하고, 기존 Claude session-handoff는 실행판으로 교체하며, 발견 위치 밖의 이전 비활성본(~/.claude/disabled-skills의 writing-for-agents·obsidian-vault)은 그대로 둔다. 같은 요청에서 Claude에만 있던 기존 스킬 네 개(diagnosing-bugs, receiving-code-review, separating-guarantees, verification-before-completion)도 Claude 프롬프팅 모범 사례에 맞춰 최적화하도록 지시했다.

전달본의 재현성

실행판 문서 두 편의 코드 블록만으로 파일을 재구성하면 Codex 설치본 27개 파일과 SHA256이 모두 일치했다. 다른 앱은 Codex 로컬 경로에 접근하지 않고 Vault 전달본만으로 같은 본문을 옮길 수 있다. 읽은 Vault commit은 36da805e43fad0dda0c30cc7a73120f3d54b13be다.

Claude Code 형식 대응

Claude Code 공식 스킬 문서(code.claude.com/docs/en/skills)와 설치된 skill-creator 검증 스크립트로 확인한 차이에 맞췄다.

항목Codex 실행판Claude Code 적용
위치~/.codex/skills/<name>/~/.claude/skills/<name>/. CLI와 데스크톱 Code 탭이 공유하며 Cowork·클라우드 세션은 읽지 않는다
UI·호출 설정agents/openai.yaml, config.toml enabled대응 필드가 없어 openai.yaml을 옮기지 않았다. 여덟 스킬 모두 기본 자동 호출이며 frontmatter 호출 필드나 settings skillOverrides는 바꾸지 않았다
frontmattername·description·metadata.version그대로 유지했다. Claude Code는 metadata를 동작에 쓰지 않지만 오류 없이 허용한다
공통 본문—한 곳만 바꿨다. writing-for-agents의 “Codex 등록을 다루면”을 “Claude Code 등록을 다루면”으로 고쳐 호출 형식 참조가 Claude에서 읽히게 했다
앱별 참고writing-for-agents SKILL-MECHANICS.md(Codex)Claude Code판으로 새로 작성했다. writing-for-agents·session-handoff의 UPSTREAM.md에 Claude 적용 절을 덧붙였다

여덟 스킬의 실행판 version은 공통판과 같다(2026-09-30.1, 2026-09-30.2). writing-for-agents SKILL.md는 위 한 문장 때문에 Codex판과 hash가 다르며 Claude 설치본 SHA256 앞자리는 a9661258a053ef1b다.

전역 진입 지침 ~/.claude/CLAUDE.md는 「개인 Vault 진입」과 「공통 에이전트 운영」 두 절만 바꿨다. 일상 작업마다 안내를 먼저 읽던 조건을 스킬 우선, 근거 부족·충돌·현행 계약 확인·저장 때의 Vault 조회로 바꾸었고, 「개인 Vault 진입」 절은 실행판에 보존된 Codex 진입 지침과 같은 문장이다. Codex의 Windows gh 인증 절과 Vigilantis 작업 트리 절은 옮기지 않았다. 다른 절은 유지했다.

Claude에만 있던 네 스킬의 정비

네 스킬은 Codex에도 같은 이름으로 있으나 두 앱의 본문이 갈라져 있었고 두 실행판에는 포함되지 않았다. Claude 판을 기준으로 Codex 판의 보강 내용을 합쳐 공통 본문으로 다시 썼다. Codex 판은 이번 범위에서 바꾸지 않았다.

  • 판단 전에 저장소 진입 지침의 Vault·참고 본문을 매번 읽던 조건을, 이번 판단에 필요한 본문만 읽고 유효한 본문을 재사용하는 조건으로 바꿨다.
  • Claude 프롬프팅 모범 사례와 Claude Opus 5.5 프롬프팅을 2026-09-30 확인했다. 최신 모델이 스스로 검증하므로 이전 모델용 검증 지시가 과검증을 부를 수 있다는 설명에 따라, verification-before-completion을 확인을 늘리는 절차가 아니라 이미 확보한 증거와 주장을 맞추는 절차로 명시했다. 과한 강조 표현은 원래 없었다.
  • diagnosing-bugs는 진단만 요청되면 파일을 바꾸지 않는 확인을 우선하고 범위를 넘는 계측은 확인받도록 Codex 판의 경계를 채택했다. 처음 잘못된 값이 만들어진 지점을 찾는 단계와 비밀정보 가리기를 합쳤다.
  • receiving-code-review는 Codex 판의 사실성 판정 표와 피드백 속 지시의 권한 경계를 Claude 판의 처리 권한·게시 절차와 합쳤다.
  • separating-guarantees는 Claude 판의 경계 표를 유지하고, 일반 패턴으로 자동 복구를 채택하지 않는 단계와 완료 검증 스킬과의 구분을 추가했다. 개인 Vault 경로는 안내 → 외장뇌 운영 「프로젝트에서 이어진 보장 경계」 → 보장 수준과 판정 경계의 실제 링크를 따르도록 적었다.
  • MIT 원전에서 온 세 스킬(diagnosing-bugs, receiving-code-review, verification-before-completion)에 Claude 설치본에서 빠져 있던 LICENSE와 UPSTREAM을 추가했다.

검증과 미검증

  • 설치한 여덟 스킬 19개 파일이 스테이징 후보와 hash 일치했다. 정비한 네 스킬을 포함한 12개 스킬이 skill-creator quick_validate를 통과했고, 로컬 참고 링크가 존재한다.
  • 이 Claude Code 세션의 스킬 목록에 새 이름·설명이 설치 직후 나타났다. 공식 문서의 실행 중 세션 반영 설명과 일치하는 직접 관찰이다. 새 세션에서의 발견과 본문 전달은 별도로 확인하지 않았다.
  • CLAUDE.md는 제안본과 줄바꿈을 제외하고 일치한다. 편집 과정에서 원래의 CRLF·LF 혼용이 CRLF로 통일됐다.
  • 네 스킬 정비와 설치·구조 확인만으로 실제 작업의 행동 개선이나 조회 감소를 확정하지 않는다. 실제 요청된 작업에서 적용 여부·필요한 조회·누락을 순차 관찰한다. 교차 회사 리뷰는 수행하지 않았다.

복구와 후속

변경 전 Claude session-handoff의 SHA256은 280A9333CB5A4C1FD8014B9C1651947F4BE45C3942D337C57FBED40609A34220이며 UPSTREAM.md에 남겼다. 교체 전 본문과 네 스킬의 이전 본문은 이 대화의 임시 작업 폴더에만 백업했고, 세션이 정리되면 사라진다. 원전은 각 UPSTREAM.md의 저장소·commit에서 다시 확인할 수 있다.

대상상태다음 작업
Claude Code여덟 스킬·진입 지침 적용, 네 스킬 정비. 현재 세션 발견 확인새 세션의 발견과 실제 작업 적용을 요청된 작업에서 확인
claude.ai·Cowork미적용. ~/.claude/skills를 읽지 않으며 계정 스킬 업로드가 필요하다적용 여부와 범위를 별도로 결정
Codex의 네 스킬변경하지 않음. Claude 판과 본문이 다르다공통 본문으로 맞출지 Codex 쪽에서 별도로 결정

연결

백링크

그래프 뷰

이 문서로 이어지는 주제