riqxa/skills-best-practices

skills-best-practices은(는) 무엇을 하나요?

효율적인 에이전트 스킬을 구축, 검증 및 구성하기 위한 명확한 지침을 제공합니다. 집중된 컨텍스트 관리를 지원합니다.

개요

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)를 위한 스킬을 설계하고 문서화하기 위한 모범 사례를 정의합니다. 일관된 스킬 구조를 만들고, 스킬 마크다운 파일로 컨텍스트를 효과적으로 관리하며, 일반적인 설계 함정을 피하는 데 중점을 둡니다.

주요 원칙

• 집중된 컨텍스트: 각 스킬은 단일 문제를 해결하고 명확한 경계를 가져야 합니다.
• 명확한 문서화: 스킬 설명서는 간결하고 구조화되어야 합니다.
• 플랫폼 중립성: 스킬은 특정 에이전트에 종속되지 않도록 설계되어야 합니다.
• 검증 가능성: 스킬이 올바르게 작동하는지 확인하기 위한 명확한 테스트 기준이 있어야 합니다.

모범 사례

1. 스킬 구조

my-skill/
├── SKILL.md          # 스킬 설명서 및 구성
├── commands/         # 선택적: 명령어 정의
│   └── example.sh
├── tests/            # 선택적: 검증 스크립트
│   └── test_skill.sh
└── README.md         # 선택적: 추가 정보

2. SKILL.md 형식

SKILL.md 파일은 다음 정보를 포함해야 합니다:

• 스킬 이름 및 설명
• 사용 예제
• 구성 옵션 (있는 경우)
• 종속성 및 요구 사항
• 알려진 제한 사항

3. 컨텍스트 관리

• 스킬 컨텍스트를 작고 집중적으로 유지하십시오.
• 설명서에서 불필요한 세부 사항을 피하십시오. -링크나 참조를 사용하여 심층 정보를 제공하십시오.

예제

# my-greeting-skill

사용자에게 인사하는 간단한 스킬입니다.

## 사용법

사용자와 상호 작용할 때 "안녕하세요"라고 말합니다.

## 구성

없음

검증

다음을 확인하여 스킬이 올바르게 작동하는지 확인하십시오:

1. SKILL.md 형식이 올바른지 확인
2. 명령어가 예상대로 실행되는지 테스트
3. 컨텍스트 프롬프트가 의도한 동작을 생성하는지 확인

일반적인 함정

• 과도한 컨텍스트: 너무 많은 정보로 스킬을 과부하시키지 마십시오.
• 모호한 설명: 모호하거나 부정확한 설명을 피하십시오.
• 플랫폼 종속성: 특정 에이전트에 강하게 종속되는 스킬을 만들지 마십시오.

라이선스

이 스킬은 MIT 라이선스에 따라 제공됩니다.