occ-tools/codex-skills-registry

codex-skills-registry은(는) 무엇을 하나요?

Codex Skills, 플러그인 매니페스트, MCP 서버 구성을 검증, 인덱싱 및 테스트하여 오픈소스 유지보수 워크플로우를 지원합니다.

개요

이 레지스트리는 Codex Skills와 관련 플러그인 설정의 일관성과 정확성을 유지하는 데 도움을 줍니다. 검증, 인덱싱, 테스트 자동화를 통해 유지보수 과정에서 발생할 수 있는 오류를 사전에 방지합니다.

지원 플랫폼

• Claude Code
• Cursor
• Codex
• 기타 AI 에이전트 환경

주요 기능

• 스킬 매니페스트 검증: 스킬 정의 파일(skill.md, skill.yaml 등)의 필수 필드와 형식을 확인합니다.
• 플러그인 설정 검사: MCP 서버 설정(mcp.json, config.yaml)의 구문과 참조 무결성을 검증합니다.
• 인덱스 생성: 검증된 스킬과 플러그인의 인덱스를 자동 생성하여 레지스트리를 최신 상태로 유지합니다.
• 테스트 실행: 각 스킬과 플러그인의 기본 동작을 테스트하여 호환성을 보장합니다.

사용 예시

# 스킬 검증 실행
npx occ-tools validate --skill ./skills/my-skill

# 전체 레지스트리 인덱싱
npx occ-tools index --registry ./registry

# MCP 설정 테스트
npx occ-tools test --mcp ./config/mcp.json

설정 파일 형식

스킬 매니페스트는 일반적으로 다음 필드를 포함합니다:

name: my-skill
description: 내 스킬 설명
version: 1.0.0
platforms:
  - claude-code
  - cursor

MCP 서버 설정 예시:

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

기여하기

레지스트리에 새로운 스킬이나 플러그인을 추가하려면 CONTRIBUTING.md를 참조하세요. 모든 제출은 CI 파이프라인에서 자동 검증됩니다.

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.