Community코딩 & 개발github.com

스킬 정리기

Codex/OpenClaw 스킬 감사: 실시간 예산, 사용량, 중복 항목, 간결한 설명.

스킬 정리기란 무엇인가요?

이 스킬은 Codex 및 OpenClaw 에이전트에서 사용하는 스킬 목록을 감사하고 정리하는 도구입니다. 실시간 예산 사용량을 추적하고, 중복 스킬을 식별하며, 사용되지 않는 스킬 후보를 찾아 프롬프트 예산을 절약할 수 있도록 돕습니다. 이 도구는 `codex debug prompt-input` 명령어를 통해 모델에 보이는 스킬 목록을 가져오거나, 파일 시스템을 직접 스캔하여 분석합니다. 개발자는 이 분석 결과를 바탕으로 설명을 간결하게 수정하거나, 중복 스킬을 삭제하거나, 비활성화할 스킬을 결정할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/skill-cleaner

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

스킬 정리기은(는) 무엇을 하나요?

스킬 프롬프트 예산을 줄이거나, 중복 스킬을 찾거나, 활성화/비활성화된 스킬 루트를 감사하거나, 제거할 스킬/플러그인을 결정할 때 사용하세요.

워크플로

  1. 이 스킬 디렉터리 또는 레포지토리 루트에서 분석기를 실행합니다:
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
  1. 다음 순서로 보고서를 읽습니다:
  • 스킬 예산: 실시간 Codex 인벤토리, 2% 예산, 예산 사용량, 전체 설명 압박.
  • 설명 후보: 완화된 문법으로 프롬프트 예산을 절약할 수 있는 긴 설명.
  • 중복: Codex, 플러그인 캐시, 레포지토리 형제, 개인 스킬 루트에서 동일한 스킬 이름 또는 거의 동일한 설명/본문.
  • 미사용 후보: 최근 Codex/OpenClaw 로그에서 사용자 언급이나 실제 SKILL.md 읽기가 없는 항목.
  • 루트 요약: 스킬의 출처와 구성에서 비활성화로 표시되었는지 여부.
  1. 삭제 또는 편집 전:
  • 보관된 복사본이 존재하고 로드되었는지 확인합니다.
  • 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.5 context_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 언급 및 도구 호출 인수에서 관찰된 경로.

출력 정책

  • 먼저 제안하고, 사용자가 요청할 때만 편집합니다.
  • 정리 적용을 요청받으면 작은 그룹으로 커밋합니다: 설명, 삭제, 구성 비활성화.
  • 무시되거나 추적되지 않은 스킬 디렉터리를 대상이나 삭제 가능 여부를 확인하지 않고 삭제하지 마십시오.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

관련 스킬