Community라이팅 & 에디팅github.com

iosrxwy/skillint

AI 에이전트 스킬을 위한 정적 분석 도구입니다. Codex, Cursor, Claude Code에서 사용하는 SKILL.md와 AGENTS.md를 감사합니다.

skillint란 무엇인가요?

skillint는 AI 에이전트 개발 환경에서 스킬 정의 파일(SKILL.md, AGENTS.md)을 정적으로 분석하고 최적화하는 CLI 도구입니다. Codex, Cursor, Claude Code, Grok 등 여러 에이전트 플랫폼에서 사용되는 수많은 스킬이 에이전트 성능을 저하시키는 것을 방지하기 위해 설계되었습니다. 이 도구는 스킬의 중복 여부, 누락된 설명, 과도한 토큰 사용량, 항상 활성화되는 규칙 등을 점검하고, 격리 기반 정리(quarantine-based cleanup), 심볼릭 링크를 통한 공유, 드라이런 기반 명령어 등을 제공하여 안전하게 스킬을 관리할 수 있도록 돕습니다. CI/CD 파이프라인에 통합할 수 있으며, `npx skillint`를 통해 글로벌 설치 없이 사용할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add iosrxwy/skillint

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

skillint은(는) 무엇을 하나요?

더 많은 스킬을 추가하기 전에 skillint CLI를 실행하세요. 너무 많은 스킬은 에이전트를 느리게 만들고 성능을 떨어뜨립니다.

명령어

npx skillint scan
npx skillint map --agent cursor
npx skillint doctor
npx skillint audit
npx skillint ui
npx skillint tokens
npx skillint prune
npx skillint fix
npx skillint adopt
npx skillint link
npx skillint update
npx skillint report --html
npx skillint badge
npx skillint scan-remote owner/repo
npx skillint mcp

규칙

  • 사용자가 전역 설치할 필요가 없도록 npx skillint 사용을 권장합니다.
  • 에이전트 간 실제 스킬 목록을 조회하려면 scan을, 특정 에이전트의 문서화된 카탈로그 해석을 보려면 map --agent ...를 사용하세요.
  • map이 특정 모델이 스킬을 트리거할지 예측한다고 주장하지 마세요. conditional 및 unknown 결과는 그대로 유지하세요.
  • 정리는 격리 기반으로 이루어집니다: prune --apply와 trash는 항목을 ~/.skillint/trash로 이동합니다. restore는 마지막 배치를 취소합니다. 스킬에 rm을 직접 사용하지 마세요.
  • Cursor, Claude, Codex, Grok에 동일한 복사본이 있으면 삭제하지 말고 skillint link를 사용하여 하나의 표준 복사본을 공유하세요.
  • link --apply와 update --apply만이 변경을 수행하는 관리자 명령어입니다. 기본적으로 드라이런(dry-run) 모드로 실행됩니다.
  • 중복된 이름, 누락된 설명, 지나치게 큰 본문을 먼저 보고합니다.
  • audit는 파일:줄 번호를 출력하는 정적 패턴 스캔입니다. 일치 항목은 사람이 검토해야 하며 자동으로 수정되지 않습니다.
  • 토큰 추정치는 문자 수 / 4입니다. 이는 정확한 토크나이저 수가 아닌 추정치임을 명시하세요.
  • 스캔 후에는 스킬 개수, 건강 점수, 메타데이터 토큰, 본문 전체 토큰, 항상 활성화된 규칙 토큰을 요약합니다.
  • 사용자가 공급업체 복사본을 건너뛰려는 경우 .skillintignore 및 --ignore를 언급하세요.
  • CI에서는 uses: iosrxwy/skillint@main 또는 node dist/cli.js doctor --fail-on error를 사용하는 것이 좋습니다.

관련 스킬