Codex Skills가 설치되었지만 트리거되지 않는다면, 먼저 스캔 디렉터리에 위치와 SKILL.md가 완전한 name 및 description을 가지고 있는지 확인한 후 명시적으로 확인 호출을 하세요. 대부분의 문제는 "발견되지 않은 기술" 또는 "설명이 과제와 일치하지 않는다"는 것입니다.
디렉터리는 올바르게 설정되어야 하며, 파일 이름이 변경되어서는 안 됩니다
창고 전용 기술은 다음 분야에 위치해 있습니다:
$REPO_ROOT/.agents/skills/skill-name/SKILL.md모든 프로젝트에 적용되는 범용 개인 기술은 다음과 같습니다:
~/.agents/skills/skill-name/SKILL.md코덱스는 현재 디렉터리에서 저장소 루트 디렉터리로 .agents/skills 스캔합니다. 창고 외부의 인접 디렉터리에 배치된 기술이나 별도의 기술 폴더가 누락된 경우, 감지되지 않을 수 있습니다.
설명이 언제 발동할지 결정합니다
최소 사용 가능한 파일에는 YAML 헤더 정보가 포함되어야 합니다:
---
name: release-checker
description: Use when checking whether a web project is ready to release, including build, tests and rollback verification.
---
Follow the project release checklist and report every failed check.name 안정적이고 중복된 이름을 피하세요; description 사용자 목표, 트리거 조건, 경계를 명확히 명시하세요. "매우 유용한 출판 기술"만 쓰는 것은 작업 신호와 일치하지 않습니다; 핵심 시나리오는 설명 시작 부분에 배치해야 합니다.
명시적 호출은 두 가지 유형의 문제를 구분할 수 있습니다
CLI 또는 IDE 확장 프로그램에서 /skills 입력하면 목록을 볼 수 있고, $ 입력하면 스킬을 선택하세요. $release-checker 선택되고 실행된다면 설치가 제대로 작동하고 있다는 뜻입니다. 최적화가 필요한 것은 description; 목록에 없다면 디렉터리, 파일명, YAML 형식을 확인하세요.
스킬 업데이트는 보통 자동으로 발견됩니다; 코덱스가 새로고침되지 않으면 재시작하세요. 기술이 너무 많으면 초기 목록이 맥락 예산에 제한되고, 설명이 축약되며, 일부 기술이 생략되거나 프롬프트가 나타날 수 있습니다. 이 시점에서는 관련 없는 스킬을 비활성화하거나 필수 스킬을 명시적으로 호출해야 합니다.
같은 name의 스킬은 자동으로 합쳐지지 않습니다. 먼저 /skills에서 경로를 확인하고 올바른 버전을 유지한 후 테스트하세요.
