>_

스킬 만들기 5단계

첫 번째 Agent Skill을 만들기 위한 단계별 가이드입니다.

1단계: 핵심 니즈 파악하기

내용을 작성하기 전에 다음을 명확히 정의하세요:

  • 문제: 스킬이 해결하는 과제는?
  • 대상: 이 스킬을 사용할 사람은?
  • 범위: 스킬이 다루는 것과 다루지 않는 것은?

답해야 할 질문들

  1. AI가 이 스킬로 어떤 작업을 수행할까?
  2. 어떤 도메인 지식이 필요한가?
  3. AI가 어떤 동작을 보여야 하는가?
  4. 어떤 일반적인 실수를 피해야 하는가?

예시

문제: 개발자들에게 일관된 코드 리뷰 피드백이 필요함 대상: 풀 리퀘스트를 사용하는 개발팀 범위: 코드 품질, 보안, 스타일 - 프로젝트 관리는 제외

2단계: 이름 필드 작성하기

스킬 이름은 다음과 같아야 합니다:

  • 서술적: 스킬이 무엇을 하는지 명확히 표시
  • 간결함: 최대 3-5단어
  • 고유함: 유사한 스킬과 구별

좋은 이름

  • "React Component Guidelines"
  • "API Security Checker"
  • "Brand Voice Guide"

나쁜 이름

  • "My Skill" (서술적이지 않음)
  • "The Ultimate Complete Development Guide for Everything" (너무 김)
  • "Helper" (구체적이지 않음)

3단계: 설명 작성하기

설명은 검색 결과와 스킬 카드에 표시됩니다. 중요하게 작성하세요:

  • 처음 100자: 가장 중요함 - 미리보기에 표시됨
  • 키워드 포함: 사용자가 스킬을 찾는 데 도움
  • 구체적으로: 주요 기능이나 사용 사례 언급

템플릿

[동작] for [대상] that [핵심 이점]. Covers [주요 기능].

예시

Code review guidelines for development teams that ensure consistent, high-quality feedback. Covers security, performance, and style checks.

4단계: 메인 콘텐츠 작성하기

명확성과 효과를 위해 콘텐츠를 구조화하세요:

맥락 섹션

배경 정보 제공:

markdown
## Context

This skill helps AI assistants review code with a focus on:
- Security vulnerabilities
- Performance optimization
- Code style consistency
- Best practice adherence

가이드라인 섹션

구체적인 규칙 나열:

markdown
## Guidelines

1. Always check for input validation
2. Look for potential SQL injection
3. Verify error handling exists
4. Check for hardcoded credentials
5. Review logging practices

예시 섹션

예상 동작 보여주기:

markdown
## Examples

### Security Review Comment
"Consider using parameterized queries here to prevent SQL injection.
The current string concatenation is vulnerable to malicious input."

### Performance Review Comment
"This loop iterates over the entire array for each element.
Consider using a Set or Map for O(1) lookups instead of O(n)."

5단계: 업로드 및 테스트

저장소 생성

  1. GitHub에서 새 저장소 생성
  2. 루트에 SKILL.md 파일 추가
  3. 저장소를 공개로 설정

마켓플레이스에 제출

  1. 마켓플레이스의 /submit 방문
  2. 저장소 URL 입력
  3. "Submit" 클릭

스킬 테스트

제출 후:

  1. 선호하는 플랫폼에 스킬 설치
  2. 다양한 프롬프트로 테스트
  3. AI가 가이드라인을 따르는지 확인
  4. 결과에 따라 반복 및 개선

테스트 체크리스트

게시 전 다음 시나리오를 테스트하세요:

정상 동작

  • [ ] AI가 주요 가이드라인을 올바르게 따름
  • [ ] 예시가 적절하게 적용됨
  • [ ] 톤과 스타일이 기대에 맞음

엣지 케이스

  • [ ] 비정상적인 입력을 우아하게 처리
  • [ ] 다른 스킬과 충돌하지 않음
  • [ ] 지원되는 모든 플랫폼에서 작동

범위 외

  • [ ] AI가 관련 없는 주제에서 올바르게 대응
  • [ ] 스킬 경계를 넘어서지 않음
  • [ ] 범위 외 요청을 우아하게 처리

다음 단계

GitHub에서 이 페이지 편집