스킬 정리기은(는) 무엇을 하나요?
스킬 프롬프트 예산을 줄이거나, 중복 스킬을 찾거나, 활성화/비활성화된 스킬 루트를 감사하거나, 제거할 스킬/플러그인을 결정할 때 사용하세요.
워크플로
- 이 스킬 디렉터리 또는 레포지토리 루트에서 분석기를 실행합니다:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 3
유용한 변형:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --no-live --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 6 --max-log-mb 800 --deep-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --context-tokens 272000 --budget-percent 2 --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --root ~/Dropbox/boxd/skills --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --root ~/.agents/skills --root-only --no-logs
- 다음 순서로 보고서를 읽습니다:
스킬 예산: 실시간 Codex 인벤토리, 2% 예산, 예산 사용량, 전체 설명 압박.설명 후보: 완화된 문법으로 프롬프트 예산을 절약할 수 있는 긴 설명.중복: Codex, 플러그인 캐시, 레포지토리 형제, 개인 스킬 루트에서 동일한 스킬 이름 또는 거의 동일한 설명/본문.미사용 후보: 최근 Codex/OpenClaw 로그에서 사용자 언급이나 실제SKILL.md읽기가 없는 항목.루트 요약: 스킬의 출처와 구성에서 비활성화로 표시되었는지 여부.
- 삭제 또는 편집 전:
- 보관된 복사본이 존재하고 로드되었는지 확인합니다.
- Codex 내장 스킬이 대체할 수 있는 경우 레포지토리 로컬 또는
agent-scripts중복을 선호하여 삭제합니다. - 레포지토리 정책이나 실시간 운영을 인코딩하는 레포지토리 로컬 OpenClaw 유지보수자 스킬은 유지합니다.
- 설명에서 트리거 명사(제품, 도구, 동작, 객체)를 보존합니다.
분석기 참고 사항
- 기본적으로
codex debug prompt-input는 정확한 모델 표시 스킬 목록, 순서, 이름, 별칭 경로를 제공합니다.--no-live는 더 넓은 파일 시스템 폴백을 강제합니다. - 넓은 파일 시스템 스캔은 중복, 비활성화, 보관 캐시 진단을 위해 유지되며, 로드된 인벤토리로 취급되지 않습니다.
- 스크립트는 Codex의 모델 표시 라인 형태를 따릅니다:
- name: description (file: path). - Codex와 유사한 프론트매터 규칙을 적용합니다: YAML 프론트매터만 허용, 부모 디렉터리의 기본 이름, 단일 라인으로 정리된
name과description. - Codex
core-skills/src/render.rs를 따릅니다:context_window의 2%, 토큰 비용ceil(utf8_bytes / 4), 그런 다음 전체 설명 -> 동등한 설명 자르기 -> 최소 라인 생략. 별칭 테이블 라인 비용이 포함됩니다. ~/.codex/models_cache.json에서 GPT-5.5context_window를 읽습니다. 폴백은 272,000 토큰 및 2%입니다.- 기본적으로 일반 Codex/플러그인/레포 스킬 루트만 스캔합니다. Dropbox 아카이브와 같은 추가 폴더는
--root <path>로만 포함됩니다. --root-only는 최소 하나의--root <path>가 필요하며, 실시간 Codex 인벤토리를 건너뛰고 제공된 루트만 스캔합니다.- 루트를 realpath로 중복 제거하므로,
~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills와 같은 심볼릭 링크 루트는 잘못된 중복을 생성하지 않습니다. - 중복 이름의 경우 설명/본문 유사성을 보고하고 본문이 거의 복사본인 경우에만 삭제 후보를 제안합니다. 유지 우선순위는 기본적으로 직접 Codex 시스템 스킬, 그 다음 직접 Codex 스킬, 플러그인 스킬, 개인/레포 복사본 순입니다.
- 기본적으로
~/.codex/history.jsonl및 최근~/.codex/sessions/**/*.jsonl을 스캔합니다. 보관된 세션과 일반적인 OpenClaw/Clawd 로그 폴더의 경우--deep-logs를 추가합니다. - 사용 증거는 휴리스틱입니다: 사용자의
$skill/use skill언급 및 도구 호출 인수에서 관찰된 경로.
출력 정책
- 먼저 제안하고, 사용자가 요청할 때만 편집합니다.
- 정리 적용을 요청받으면 작은 그룹으로 커밋합니다: 설명, 삭제, 구성 비활성화.
- 무시되거나 추적되지 않은 스킬 디렉터리를 대상이나 삭제 가능 여부를 확인하지 않고 삭제하지 마십시오.