TL;DR

이 레포는 여러 코딩 에이전트에 공통으로 적용할 수 있는 SKILL.md 기반 스킬을 npx로 설치·관리하고, 설치 없이 스킬 프롬프트를 생성하거나 에이전트와 바로 연결할 수 있게 해 주는 CLI입니다. GitHub shorthand·전체 URL·tree 경로·SSH/HTTPS 등 다양한 소스 유형과 비공개 리포지토리 인증 플로우를 지원하며, 기본 탐색 경로와 `--full-depth` 옵션으로 스킬을 발견합니다. 심볼릭링크 기반 설치를 권장하고 전역/프로젝트 스코프, 자동 업데이트·CI 친화 옵션, 에이전트별 호환성 매트릭스가 있어 여러 에이전트를 동시에 관리하거나 팀 차원으로 스킬을 배포하려는 경우 유용합니다.

핵심 포인트

• 레포지토리는 오픈 에이전트 스킬 생태계용 커맨드라인 인터페이스(CLI) 도구로서 동작하며, 설치와 즉시 사용을 모두 지원합니다. 사용자는 `npx skills add <source>`로 원격 또는 로컬 소스에서 SKILL.md를 설치할 수 있고 `npx skills use <source>`로 설치 없이도 스킬의 프롬프트를 생성하거나 지원되는 에이전트와 대화 세션을 바로 시작할 수 있습니다. README에는 OpenCode, Claude Code, Codex, Cursor와 ‘72 more’로 표기된 다수의 에이전트 지원을 명시해 에이전트 범용성 측면에서 설계된 툴임이 분명합니다.
• 설치 소스와 인증 처리 방식이 다양하게 설계되어 있어 GitHub shorthand, 전체 URL, Git tree 경로, GitLab, SSH/HTTPS git URL, 로컬 경로 등 여러 입력 형식을 허용합니다. 비공개 리포지토리 복제 시 우선 로컬 Git 인증을 사용하고 실패하면 gh( GitHub CLI )를 시도한 뒤 SSH로 폴백하며, `GITHUB_TOKEN` 또는 `GH_TOKEN` 환경변수를 명시하면 API 접근과 업데이트 검사에 활용할 수 있습니다. 다운로드와 압축 해제에 대한 기본 제한(예: 10 MiB 다운로드, 25 MiB 추출, 1000개 파일)과 이를 덮어쓰는 환경변수도 제공되어 자동화·CI 환경에서 안전하게 동작하도록 설계되어 있습니다.
• 스킬은 SKILL.md 파일과 YAML frontmatter(필수: name, description)를 기본 규격으로 사용하고, 레포지토리 내 여러 표준 위치(루트, skills/, 여러 에이전트별 디렉터리 등)를 깊이 제한(기본 3레벨)으로 탐색합니다. `--full-depth`로 이 탐색 범위를 확장할 수 있고, `.claude-plugin/marketplace.json` 같은 플러그인 매니페스트를 통한 경로 선언도 발견 경로에 포함됩니다. 설치 방식으로는 권장인 심볼릭링크와 복사 모드가 있으며 심볼릭링크는 단일 소스 업데이트 관점에서 장점이 있습니다.
• 에이전트 호환성 매트릭스와 에이전트별 특성 표가 README에 포함되어 있어 어떤 에이전트가 `allowed-tools`, `context: fork`, Hooks 같은 확장 기능을 지원하는지 확인할 수 있습니다. CLI는 로컬에서 설치된 코딩 에이전트를 자동으로 감지하고, 전역(-g)과 프로젝트 스코프 설치를 구분하여 관리하며 비대화형 모드(-y)나 에이전트 지정(-a) 같은 자동화 친화적 옵션을 제공합니다. 익명 텔레메트리가 기본으로 수집되며 `DISABLE_TELEMETRY`·`DO_NOT_TRACK` 같은 환경변수로 비활성화할 수 있습니다.