전달되는 내용을 확인합니다.
잘린 스킬 설명, 겹치는 스킬, 예전 모델에 맞춰진 지침을 찾습니다.
← 모든 프로젝트SKILL / OPEN SOURCE
Astra Xray
잘 읽히는 지침으로.
제대로 쓰이는 스킬로.
잘린 스킬 설명, 중복된 내용, 오래된 지침을 점검합니다. Astra가 읽을 내용을 확인하고, 승인한 항목만 백업한 뒤 정리합니다.
03 / CODEX · ASTRA
SKILL.md→references/
− 겹치거나 오래된 지침
+ 필요한 내용이 끝까지 전달되도록
LUCIANLABS / ASTRA XRAY직접 만들고, 함께 씁니다.
HOW IT WORKS
이렇게 사용합니다.
수정할 항목을 고릅니다.
무엇을 왜 바꿀지 먼저 보여줍니다. 승인한 파일은 수정하기 전에 ZIP으로 백업합니다.
정리한 결과를 비교합니다.
다시 검사해 전후 차이를 보여줍니다. Codex 기본 스킬과 플러그인, 모델·권한 설정은 변경하지 않습니다.
IN DEPTH
자세히 알아보기
스킬 설명이 왜 잘리는지, 정리하면 무엇이 달라지는지 실제 결과로 정리했습니다.
왜 필요한가
Codex는 스킬 목록에 컨텍스트의 2%만 내줍니다. 스킬이 많아지면 각 설명이 중간에 잘린 채 모델에게 넘어가고, 모델은 그 스킬을 언제 써야 하는지 끝까지 읽지 못합니다. 겹치는 스킬이나 예전 모델에 맞춰 쓴 지침도 같은 문제를 키웁니다.
목록을 계산하는 규칙은 Codex 0.154.0 소스의 스킬 목록 규칙을 그대로 옮겼고, 실제 세션 로그와 84줄 중 84줄이 일치했습니다.
실제 결과
46 / 84Mac에서 설명이 잘린 채 넘어가던 스킬. 정리 후 남은 64개는 모두 온전히 전달
2,939 → 1,452자Windows에서 개인 스킬 설명 9개를 절반 길이로
약 300토큰호출 한 번마다 가벼워진 양
토큰 절약은 한 달 치를 Astra API 요금으로 쳐도 4달러 정도입니다. 이 도구의 목적은 비용이 아니라 모델이 스킬 설명을 끝까지 읽게 하는 것입니다. 토큰이 정말 많이 나가는 곳(도구 결과와 스킬 본문)은 Codex Token Xray가 잽니다.
건드리지 않는 것
- Codex 기본 스킬과 플러그인(computer-use, sites 등)
- 모델, 승인, 샌드박스, MCP 설정
- 프로덕션·비밀번호·배포를 지키는 규칙. 문장은 다듬어도 규칙은 지우지 않습니다.
- 남이 만든 인기 스킬
검사 결과와 백업은 ~/.astra-xray 아래에만 둡니다. 바꾸기 전에 모든 파일을 zip으로 백업하므로 언제든 되돌릴 수 있습니다.
자주 묻는 질문
Node.js 없이 설치할 수 있나요?
저장소를 내려받아 skills/astra-xray 폴더를 ~/.agents/skills/에 복사하면 됩니다.
왜 정리가 필요한지 더 알고 싶어요.
OpenAI의 Astra 스킬과 프롬프트 글에 배경이 있습니다.
GET STARTED내 작업에
내 작업에
바로 써보세요.
설치 후 Codex에서 $astra-xray를 입력하세요. Python 3.9 이상이 필요합니다.