skill-preflight — AI 에이전트 스킬 사전 설치 안전 점검 도구은(는) 무엇을 하나요?
AI 에이전트 스킬의 설치 전 안전성, 토큰 사용량 및 유지보수성을 평가하는 사전 점검 도구입니다.
설명
이 스킬은 사용하려는 AI 에이전트 스킬을 설치하기 전에 다음과 같은 항목을 자동으로 평가합니다:
- 안전성(Safety): 스킬 코드 내 악의적인 동작, 환경 변수 오용, 네트워크 요청 위험 여부 확인
- 토큰 효율(Token Efficiency): 스킬 실행 시 예상되는 토큰 소모량 분석 및 권장 임계값과 비교
- 유지보수성(Maintainability): 코드 품질, 문서화 상태, 의존성 관리 수준 평가
지원 플랫폼
- Claude Code (Claude CLI)
- Cursor
- Codex
- 기타 AI 에이전트 환경
사용 방법
스킬을 설치하기 전에 다음 명령을 실행하여 사전 점검을 수행합니다:
preflight --skill <skill-name-or-path>
또는 스킬 저장소를 직접 지정할 수 있습니다:
preflight --repo <repository-url>
출력 예시
🔍 Preflight Analysis for 'example-skill'
─────────────────────────────
✅ Safety: Pass (no suspicious code detected)
⚠️ Token Efficiency: Warning (estimated 12k tokens, threshold 10k)
✅ Maintainability: Pass (good documentation, clean code)
참고 사항
- 스킬의 정확한 평가를 위해서는 최신 버전의 스킬 매니페스트(
SKILL.md)가 필요합니다. - 평가 결과는 참고용이며, 실제 실행 환경에 따라 다를 수 있습니다.
라이선스
MIT