skyswordw/skillport

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

에이전트 스킬을 위한 정적 교차-에이전트 이식성 린터 — SKILL.md가 Claude Code, Codex, Cursor에서 작동할까요?

개요

skyswordw/skillport는 여러 AI 에이전트 플랫폼(예: Claude Code, Codex, Cursor) 간에 SKILL.md 파일의 호환성을 검사하는 정적 분석 도구입니다. 각 플랫폼은 고유한 명세와 제약 조건을 가지므로, 이 도구는 작성한 스킬이 다른 환경에서도 문제없이 동작할 수 있도록 도와줍니다.

사용법

CLI

npx skyswordw/skillport check ./path/to/SKILL.md

CI/CD 통합

GitHub Actions 워크플로에 추가하여 PR 병합 전 자동으로 검사할 수 있습니다:

- name: Check SKILL.md portability
  run: npx skyswordw/skillport check .github/skills/SKILL.md

지원 플랫폼

• Claude Code
• Codex (GitHub Copilot)
• Cursor
• (기타 확장 가능)

검사 항목

• 마크다운 구조: 제목, 리스트, 코드 블록 등이 각 플랫폼에서 올바르게 파싱되는지 확인
• 지시문 호환성: 각 플랫폼이 지원하는 지시문만 사용했는지 검사
• 파일 경로: 플랫폼별 파일 시스템 접근 규칙 준수 여부
• 환경 변수: 표준 환경 변수 사용 여부
• 확장 기능: 플랫폼 고유 기능 사용 시 경고 표시

설정

프로젝트 루트에 skillport.config.js 파일을 생성하여 특정 규칙을 비활성화하거나 사용자 정의할 수 있습니다:

module.exports = {
  rules: {
    "no-claude-specific": "warn",
    "no-codex-specific": "error",
  },
  platforms: ["claude-code", "codex", "cursor"],
};

라이선스

MIT