GitHub Copilot에 에이전트 기술 추가

특정 작업을 할 때 Copilot의 동작과 기능을 수정할 수 있습니다.

이 기사에서

참고

에이전트 기술은 Copilot 클라우드 에이전트 및 GitHub Copilot 명령 줄 인터페이스 (CLI) 그리고 Visual Studio Code의 에이전트 모드와 함께 작동합니다.

에이전트 기술은 특수 작업에서 성능을 향상시키기 위해 관련될 때 로드할 수 있는 Copilot 지침, 스크립트 및 리소스의 폴더입니다. 자세한 내용은 에이전트 기술에 대하여을(를) 참조하세요.

기술 만들기 및 추가

에이전트 기술을 만들려면, SKILL.md 파일을 작성하고, 필요에 따라 SKILL.md 지침에서 참조할 추가 리소스로 Markdown 파일 또는 스크립트를 사용할 수 있습니다.

  1. 아직 생성하지 않았다면 다음 위치 중 하나에 skills 디렉터리를 만드세요. 여기서 기술을 찾을 수 있으며, 나중에 만들려는 다른 모든 기술을 찾을 수 있습니다.

    단일 리포지토리와 관련된 프로젝트 기술의 경우, 리포지토리에 .github/skills, .claude/skills, 또는 .agents/skills 디렉토리를 만드십시오.

    프로젝트 간에 공유되는 개인 기술의 경우, 로컬 홈 디렉터리에 ~/.copilot/skills, ~/.claude/skills, 또는 ~/.agents/skills 디렉토리를 만듭니다.

  2.        `skills` 디렉터리 내에서 새 기술에 대한 하위 디렉터리를 만듭니다. 각 기술에는 자체 디렉터리(예: `.github/skills/webapp-testing`)가 있어야 합니다.

    기술 하위 디렉터리 이름은 소문자여야 하며 공백에 하이픈을 사용해야 합니다.

  3. 기술 하위 디렉터리에서 기술 지침이 SKILL.md 포함된 파일을 만듭니다.

    중요

    기술 파일의 이름을 지정 SKILL.md해야 합니다.

           `SKILL.md` 파일은 YAML 프런트매터가 있는 Markdown 파일입니다. 가장 간단한 형식으로 다음을 포함합니다.
    • YAML Frontmatter
      • 이름 (필수): 기술에 대한 고유 식별자입니다. 공백에 하이픈을 사용하는 소문자여야 합니다. 일반적으로 기술 디렉터리의 이름과 일치합니다.
      • 설명 (필수): 기술이 수행하는 작업 및 사용해야 하는 시기에 Copilot 대한 설명입니다.
      • 라이선스 (선택 사항): 이 기술에 적용되는 라이선스에 대한 설명입니다.
    • Markdown 본문에는 Copilot가 따라야 할 지침, 예제 및 설명서가 포함되어 있습니다.

  4. 필요에 따라 스크립트, 예제 또는 기타 리소스를 기술 디렉터리에 추가합니다.

    자세한 내용은 "스크립트를 실행하는 기술 사용"을 참조하세요.

예제 SKILL.md 파일

          **프로젝트 능력**의 경우 이 파일은 리포지토리의 디렉터리에 위치하게 됩니다`.github/skills/github-actions-failure-debugging`.

          **개인 스킬**의 경우 이 파일은 `~/.copilot/skills/github-actions-failure-debugging` 디렉터리에 위치합니다.
Markdown
---
name: github-actions-failure-debugging
description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.
---

To debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:

1. Use the `list_workflow_runs` tool to look up recent workflow runs for the pull request and their status
2. Use the `summarize_job_log_failures` tool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs
3. If you still need more information, use the `get_job_logs` or `get_workflow_run_logs` tool to get the full, detailed failure logs
4. Try to reproduce the failure yourself in your own environment.
5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.

기술을 활성화하여 스크립트를 실행하기

기술이 호출되면 Copilot 기술 디렉터리의 모든 파일을 자동으로 검색하고 기술의 지침과 함께 사용할 수 있게 합니다. 즉, 기술 디렉터리에 스크립트 또는 기타 리소스를 포함하고 지침에서 SKILL.md 참조할 수 있습니다.

스크립트를 실행하는 기술을 만들려면 다음을 수행합니다.

  1.        **기술 디렉터리에 스크립트를 추가합니다.** 예를 들어 SVG 이미지를 PNG로 변환하는 기술에는 다음과 같은 구조가 있을 수 있습니다.

    .github/skills/image-convert/
├── SKILL.md
└── convert-svg-to-png.sh

  2.        **필요에 따라 기술에 필요한 도구를 미리 승인합니다.** 
       `SKILL.md` 프런트매터의 `allowed-tools` 필드를 사용하여 Copilot 사용자가 매번 확인하지 않고도 사용할 수 있는 도구를 나열할 수 있습니다. 도구가 필드에 `allowed-tools` 나열되지 Copilot 않은 경우 사용하기 전에 사용 권한을 묻는 메시지가 표시됩니다.

    ---
name: image-convert
description: Converts SVG images to PNG format. Use when asked to convert SVG files.
allowed-tools: shell
---

    경고

    이 기술 및 참조된 스크립트를 검토하고 그 출처를 완전히 신뢰하는 경우에만 shell 또는 bash 도구를 미리 승인하십시오. 터미널 명령을 실행하기 shell 위한 확인 단계를 사전 승인하거나 bash 제거하며, 공격자가 제어하는 기술 또는 프롬프트 삽입이 사용자 환경에서 임의의 명령을 실행하도록 허용할 수 있습니다. 의심스러운 경우 shell에서 bash 및 allowed-tools을 생략하여 Copilot가 터미널 명령을 실행하기 전에 명시적인 확인을 요청하도록 해야 합니다.

  3.        **스크립트를 사용하는 방법을 Copilot에게 알려주는 지침을 작성합니다.** Markdown 본문에서 `SKILL.md`의 스크립트를 실행할 때와 방법을 설명합니다.

    When asked to convert an SVG to PNG, run the `convert-svg-to-png.sh` script
from this skill's base directory, passing the input SVG file path as the
first argument.

다른 사용자가 만든 기술 추가

사용자 고유의 기술을 만드는 것 외에도 다른 사용자가 만든 기술을 추가할 수도 있습니다.

팁

          GitHub CLI에서 `gh skill`를 사용하여 에이전트 기술을 검색, 설치, 업데이트 및 게시할 수도 있습니다. 자세한 내용은 [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/add-skills#managing-skills-with-github-cli)을(를) 참조하세요.

  1. 기술 디렉터리(즉, SKILL.md 파일이 포함된 디렉터리 및 선택적으로 다른 파일 및 하위 디렉터리)를 다운로드합니다.

    예를 들어 Awesome GitHub Copilot 리포지토리에서 https://awesome-copilot.github.com/skills/ 스킬을 다운로드합니다.

  2. 파일을 .zip 다운로드한 경우, 압축을 푸세요.

  3. 기술 디렉터리를 필요한 위치로 이동합니다.

    • 단일 리포지토리에 한정된 프로젝트 기술은 .github/skills, .claude/skills 또는 .agents/skills 리포지토리에 있습니다.

    • 개인 기술의 경우 프로젝트 ~/.copilot/skills``~/.claude/skills``~/.agents/skills 간 또는 로컬 홈 디렉터리에서 공유됩니다.

          GitHub CLI를 사용하여 기술을 관리하기

참고

          `gh skill` 가 있으며 공개 미리 보기 변경될 수 있습니다. 이를 사용하려면 GitHub CLI을(를) 버전 2.90.0 이상으로 업데이트하십시오.

이 gh skill 명령을 사용하여 리포지토리에서 GitHub CLIGitHub 에이전트 기술을 검색, 설치, 업데이트 및 게시할 수 있습니다.

하위 명령의 gh skill 전체 목록을 보려면 gh skill --help을 실행하거나, GitHub CLI 매뉴얼의 gh skill 섹션을 참조하세요.

스킬 설치

기술을 검색하고, 미리 보기하고, 리포지토리에서 GitHub 설치할 수 있습니다.

경고

기술은 GitHub 에 의해 검증되지 않으며 명령 삽입, 숨겨진 지침 또는 악성 스크립트를 포함할 수 있습니다. gh skill preview를 사용하여 설치하기 전에 항상 스킬의 콘텐츠를 검사하십시오.

  1. 항목별로 기술 검색:

    gh skill search TOPIC

  2. 설치하기 전에 해당 콘텐츠를 검사하는 기술을 미리 봅니다. 이렇게 하면 아무 것도 설치하지 않고 터미널에서 기술과 SKILL.md 파일 트리를 렌더링합니다.

    gh skill preview OWNER/REPOSITORY SKILL

  3. 기술을 설치합니다. 완전히 대화형 흐름에 대한 인수 없이 실행 gh skill install 하거나 리포지토리를 지정하여 대화형으로 해당 기술을 찾아볼 수 있습니다.

    gh skill install OWNER/REPOSITORY

    특정 기술을 직접 설치하려면 다음을 수행합니다.

    gh skill install OWNER/REPOSITORY SKILL

    예를 들어 리포지토리에서 기술을 설치하려면 다음을 github/awesome-copilot 수행합니다.

    Shell
    gh skill install github/awesome-copilot documentation-writer

           `@TAG` 또는 `@SHA`를 사용하여 특정 버전을 설치할 수 있습니다.
    Shell
    gh skill install github/awesome-copilot documentation-writer@v1.2.0

    기술을 특정 버전(또는 커밋 SHA)으로 잠가서 업데이트 중에 건너뛰도록 하려면 --pin를 사용하세요.

    Shell
    gh skill install github/awesome-copilot documentation-writer --pin v1.2.0

    참고

           `@VERSION` 구문과 `--pin` 플래그는 함께 사용할 수 없습니다. 둘 다 사용하지 않고 하나 또는 다른 하나를 사용합니다.

    특정 에이전트 호스트에 대한 기술을 설치하려면 플래그를 --agent 사용합니다. 설치 범위를 제어하려면 다음을 사용합니다 --scope.

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

기술은 에이전트 호스트의 올바른 디렉터리에 자동으로 설치됩니다. 기본적으로 기술은 Copilot 프로젝트 범위에서 설치됩니다.

기술 업데이트

기술을 gh skill설치하면 원본 리포지토리, ref 및 트리 SHA를 포함하여 출처 메타데이터가 기술의 SKILL.md 프런트매터에 기록됩니다. 이 gh skill update 명령은 이 메타데이터를 사용하여 업스트림 변경 내용을 확인합니다.

대화형으로 업데이트를 확인하려면 다음을 수행합니다.

gh skill update

특정 기술을 업데이트하려면 다음을 수행합니다.

gh skill update SKILL

메시지를 표시하지 않고 설치된 모든 기술을 업데이트하려면 다음을 수행합니다.

gh skill update --all

고정된 스킬은 업데이트 중에 건너뜁니다. 고정된 기능을 업데이트하려면 새 --pin 값으로 다시 설치하세요.

게시 기술

기술 리포지토리를 유지 관리하는 경우 GitHub CLI를 사용하여 기술을 검증하고 게시할 수 있습니다.

          [에이전트 기술 사양](https://agentskills.io/specification)에 대한 기술 유효성을 검사하고 태그 보호, 비밀 검사 및 코드 검사와 같은 원격 설정을 게시하지 않고 확인하려면 다음을 사용합니다`--dry-run`.

gh skill publish --dry-run

기술 파일의 메타데이터 문제를 자동으로 해결하려면 .를 사용합니다 --fix. 이렇게 하면 사용자의 기술이 게시되지 않습니다.

gh skill publish --fix

기술의 유효성을 검사하고 게시하려면 다음을 수행합니다.

gh skill publish

에이전트 기술을 사용하는 방법 Copilot

작업을 수행할 때, Copilot는 사용자의 프롬프트와 기술 설명을 기반으로 언제 기술을 사용할지 결정합니다.

Copilot가 기술을 사용하기로 선택하면, SKILL.md 파일이 에이전트의 컨텍스트에 주입되어 에이전트가 사용자의 지침에 접근할 수 있습니다. 그런 다음 이러한 지침을 따르고 기술 디렉터리에 포함할 수 있는 스크립트 또는 예제를 사용할 수 있습니다.

기술 및 사용자 지정 지침

기술과 사용자 정의 지침을 모두 사용하여 Copilot에게 저장소에서 작업하는 방법과 특정 작업을 수행하는 방법을 가르칠 수 있습니다.

거의 모든 작업에 관련되어 있는 간단한 지침에 대해서는 사용자 지정 지침을 사용하는 것이 좋으며(예: 리포지토리의 코딩 표준에 대한 정보), Copilot가 관련 있을 때만 사용하는 보다 자세한 지침에 대해서는 기능을 활용하는 것이 좋습니다.

리포지토리 사용자 지정 지침에 대한 자세한 내용은 GitHub Copilot 대한 리포지토리 사용자 지정 지침 추가을 참조하세요.