GitHub CLI로 에이전트 스킬 관리

Source: GitHub Changelog

번역할 텍스트가 제공되지 않았습니다. 번역이 필요한 내용을 추가로 알려주시면 도와드리겠습니다.

에이전트 스킬이란?

에이전트 스킬은 AI 에이전트에게 특정 작업을 수행하는 방법을 가르치는 휴대 가능한 명령어 집합, 스크립트 및 리소스입니다.
이 스킬은 공개된 Agent Skills specification을 따르며, GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI 등 다양한 에이전트 호스트에서 작동합니다.

새로운 gh skill 명령을 사용하면 GitHub CLI에서 한 번의 명령으로 에이전트 스킬을 설치할 수 있습니다.

시작하기

GitHub CLI를 v2.90.0 이상 버전으로 업데이트하세요.

그런 다음 스킬을 탐색하고 대화형으로 설치하세요:

# 저장소에서 스킬을 찾아 대화형으로 설치
gh skill install github/awesome-copilot

# 또는 특정 스킬을 바로 설치
gh skill install github/awesome-copilot documentation-writer

# @tag를 사용해 특정 버전 설치
gh skill install github/awesome-copilot documentation-writer@v1.2.0

# 특정 커밋 SHA로 설치
gh skill install github/awesome-copilot documentation-writer@abc123def

# 스킬 탐색
gh skill search mcp-apps

스킬은 에이전트 호스트에 맞는 올바른 디렉터리에 자동으로 설치됩니다. 플래그를 사용하여 특정 에이전트와 범위를 지정할 수 있습니다:

gh skill install github/awesome-copilot documentation-writer \
  --agent claude-code --scope user

버전 고정 및 공급망 무결성

에이전트 스킬은 AI 에이전트의 동작 방식을 형성하는 실행 가능한 명령어입니다. 설치 사이에 조용히 변경되는 스킬은 공급망 위험이 됩니다. gh skill은 GitHub이 이미 제공하는 기본 기능을 활용하여 패키지 관리자에서 기대하는 동일한 보장을 스킬 생태계에 제공합니다.

• 태그와 릴리스: 모든 공개 릴리스는 git 태그와 연결됩니다. gh skill publish는 불변 릴리스를 활성화하도록 제안하므로, 릴리스 내용은 관리자조차도 게시 후에 변경할 수 없습니다.
• 콘텐츠 주소 기반 변경 감지: 설치된 각 스킬은 소스 디렉터리의 git 트리 SHA를 기록합니다. gh skill update는 로컬 SHA와 원격 SHA를 비교하여 단순 버전 상승이 아닌 실제 콘텐츠 변화를 감지합니다. 이 정보를 스킬의 front‑matter에 저장함으로써 버전 관리와 고정이 휴대 가능해지며, 여러분(또는 에이전트)이 스킬을 다른 프로젝트에 복사·붙여넣어도 변경 추적 및 업데이트 기능을 잃지 않습니다.
• 버전 고정: --pin 옵션을 사용해 스킬을 특정 태그 또는 커밋 SHA에 고정합니다. 고정된 스킬은 업데이트 시 건너뛰어지므로, 실수로가 아니라 의도적으로 업그레이드할 수 있습니다.
• front‑matter를 통한 휴대 가능한 출처 정보: gh skill이 스킬을 설치하면, 추적 메타데이터(레포지토리, ref, 트리 SHA)를 SKILL.md의 front‑matter에 직접 기록합니다. 출처 데이터가 스킬 파일 자체에 포함되기 때문에, 스킬이 어디로 이동하든 함께 전달됩니다.

# 릴리스 태그에 고정
gh skill install github/awesome-copilot documentation-writer --pin v1.2.0

# 최대 재현성을 위해 커밋에 고정
gh skill install github/awesome-copilot documentation-writer --pin abc123def

자체 스킬 게시하기

스킬 저장소를 관리하고 있다면, gh skill publish는 여러분의 스킬을 agentskills.io 사양과 비교해 검증하고, 태그 보호, 비밀 스캔, 코드 스캔과 같은 원격 설정을 확인합니다. 이러한 설정은 필수는 아니지만, 저장소의 공급망 보안을 강화하기 위해 강력히 권장됩니다.

예를 들어 불변 릴리스를 활성화하면, 누군가 저장소를 장악하더라도 기존 릴리스를 변경할 수 없게 되어 태그 고정을 통해 설치하는 사용자들이 완전히 보호됩니다. publish 명령은 이러한 기능을 손쉽게 활성화하도록 해줍니다.

# Validate all skills
gh skill publish

# Auto‑fix metadata issues
gh skill publish --fix

Source: …

기술을 최신 상태로 유지

gh skill update는 알려진 모든 에이전트 호스트 디렉터리를 스캔하고, 설치된 각 스킬의 출처 메타데이터를 읽으며, 업스트림 변경 사항을 확인합니다:

# Check for updates interactively
gh skill update

# Update a specific skill
gh skill update git-commit

# Update everything without prompting
gh skill update --all

지원되는 에이전트 호스트

자세히 알아보기

• Agent Skills 사양을 확인하세요.
• GitHub 커뮤니티에서 토론에 참여하세요.

gh skill이 공개 프리뷰로 출시되며 사전 통보 없이 변경될 수 있습니다.

스킬은 사용자의 재량에 따라 설치됩니다. GitHub에서 검증되지 않았으며 프롬프트 인젝션, 숨겨진 지시문 또는 악성 스크립트를 포함할 수 있습니다. 설치 전에 스킬의 내용을 검토할 것을 강력히 권장합니다. 이는 gh skill preview 명령을 통해 확인할 수 있습니다.

GitHub Community announcements에 참여하세요.