OpenTelemetry를 위한 OllyGarden Agent Skills

License

OpenTelemetry를 위한 OllyGarden Agent Skills는 Claude Code, Cursor, Codex, GitHub Copilot과 같은 코딩 에이전트에게 Go, Java, JavaScript, Python, .NET, Ruby 및 브라우저용 SDK 설정; Collector 구성 및 OTTL; 의미론적 규칙(semantic conventions); 그리고 업그레이드에 대한 정확하고 최신 OpenTelemetry 지식을 제공하는 오픈 소스 스킬입니다. 이들은 Agent Skills specification을 따르기 때문에 이를 지원하는 모든 에이전트와 작동합니다. 전체 카탈로그 및 이것들이 OllyGarden의 주관적인 skills 패키지와 어떻게 관련되는지는 ollygarden.com/resources/agent-skills에서 확인할 수 있습니다.

이 스킬들은 설계상 주관적이지 않습니다(non-opinionated by design) — OpenTelemetry를 사용하는 데에는 많은 유효한 방법들이 있으며, 규칙을 정하는 것은 범위를 벗어납니다.

이들은 토큰 효율적이며 에이전트 친화적인 검색을 위해 설계되었습니다: 컨텍스트에 문서를 복사하는 대신 작은 가져오기 테이블(fetch tables), 조회 인덱스(lookup indexes), 그리고 상위 진실 공급원(upstream sources of truth)을 가리키는 스크립트를 사용합니다. 에이전트는 훈련 과정에서 놓친 것을 찾고, 프로젝트가 발전함에 따라 답변은 최신 상태를 유지합니다.

사용 가능한 Skills

언어 불가지론적(Language-agnostic) skills:

모든 스킬 설치:

npx skills add https://github.com/ollygarden/opentelemetry-agent-skills

또는 폴더를 지정하여 단일 스킬을 설치할 수 있습니다. 예시:

npx skills add https://github.com/ollygarden/opentelemetry-agent-skills/tree/main/skills/otel-go

Claude Code

1. 저장소를 플러그인 마켓플레이스로 등록:

   복사

   /plugin marketplace add ollygarden/opentelemetry-agent-skills
   

   1

   2

2. 스킬 설치:

   복사

   /plugin install <skill-name>@opentelemetry-agent-skills
   

   1

   2

   예시:

   복사

   /plugin install otel-go@opentelemetry-agent-skills
   

   1

   2

Cursor, Codex, GitHub Copilot 및 기타 에이전트

skills CLI는 감지된 코딩 에이전트에 설치됩니다. cursor, codex, 또는 github-copilot과 같은 특정 에이전트를 선택하려면 -a를 전달하십시오:

npx skills add ollygarden/opentelemetry-agent-skills -a cursor

지원되는 모든 에이전트는 skills CLI 문서를 참조하십시오.

저장소 구조

각 스킬은 skills/ 아래의 독립적인 폴더이며, agentskills.io 사양에 따라 해당 name: 필드와 일치하는 이름으로 지정됩니다. 언어별 스킬은 작업 중심의 참조를 포함하며, 언어에 구애받지 않는(language-agnostic) 스킬들은 그 옆에 배치됩니다.

skills/
  otel-go/
    SKILL.md           # name: otel-go
...

기여

기여는 환영합니다. AI 코딩 에이전트에 의해 작성 및 구현된 풀 리퀘스트(pull request)도 포함됩니다. 전체 가이드는 CONTRIBUTING.md를 참조하십시오. 필수 사항:

• 스킬은 DRY(Don't Repeat Yourself)를 유지하세요. 추가적인 지식을 대량으로 복사하는 대신, 이미 관리되고 있는 공식 문서, 예제 및 소스 코드를 참조하는 것을 선호하세요. 예외가 있겠지만, 기본 원칙은 검증된 출처에 링크하거나 가리키는 것이어야 합니다.
• 스킬을 토큰 효율적으로 설계하세요. 타겟팅된 조회(lookup), 집중적인 참고 자료, 또는 작은 생성 아티팩트만으로 충분할 때 대용량 파일이나 광범위한 컨텍스트를 스킬에 덤프하는 것을 피하세요.
• 공급업체 중립성을 유지하세요 (Stay vendor neutral).
• 스킬은 Agent Skills specification을 준수해야 합니다. CI가 실행하는 것과 동일한 게이트인 ./bin/validate-skill.sh와 ./bin/check-skill-inventory.py로 검사하세요.
• 스킬을 추가하거나 실질적으로 변경하는 PR은 하네스 결과(harness results)를 포함해야 합니다. 즉, 스킬 유무에 따른 프론티어 모델(frontier model)에서의 동일한 프롬프트 실행 결과를 보여주어 스킬이 도움이 됨을 입증해야 합니다.
• docs/preferred-workflow.md는 브랜치부터 병합까지, 저장소 전체에서 변경 사항을 안내합니다.
• 기여자들은 첫 풀 리퀘스트(pull request) 시 조직 전체의 OllyGarden CLA에 서명해야 합니다.

모든 참여자는 OllyGarden의 Code of Conduct를 따라야 합니다. 도움말 및 이슈 라우팅은 SUPPORT.md를 참조하고, 프로젝트 역할 및 의사 결정에 대한 OllyGarden의 조직 전체 governance policy를 참고하세요. 의심되는 취약점은 상속된 security policy에 따라 비공개로 보고해야 합니다.