효과적인 설명 작성하기
스킬의 설명은 검색 가능성과 사용자 이해에 매우 중요합니다.
두 가지 설명
1. 프론트매터 설명 (200자)
표시되는 곳:
- 검색 결과
- 스킬 카드
- 마켓플레이스 목록
목표: 가치와 범위를 빠르게 전달.
2. 콘텐츠 설명 (무제한)
표시되는 곳:
- 스킬 상세 페이지
- 문서
목표: 포괄적인 이해 제공.
프론트매터 설명 팁
가치로 시작하기
스킬이 무엇인지가 아닌, 사용자가 얻는 것으로 시작하세요.
좋음:
"Write cleaner React code with component patterns, performance tips, and accessibility guidelines."
나쁨:
"This skill contains guidelines for React development."
키워드 포함
사용자가 검색으로 스킬을 찾을 수 있도록 도우세요.
좋음:
"TypeScript type safety guidelines: generics, type guards, utility types, and strict mode best practices."
나쁨:
"Guidelines for type-safe code."
범위를 구체적으로
명확한 기대치를 설정하세요.
좋음:
"API security checklist: authentication, authorization, input validation, and rate limiting for REST APIs."
나쁨:
"Security best practices."
능동적 언어 사용
행동 지향적으로 만드세요.
좋음:
"Build accessible React components with ARIA labels, keyboard navigation, and screen reader support."
나쁨:
"Accessibility information for React."
템플릿
가이드라인 스킬용
[동작] [도메인] with [핵심 기능 1], [핵심 기능 2], and [핵심 기능 3].
예시:
"Write maintainable CSS with BEM naming, utility classes, and responsive design patterns."
리뷰 스킬용
[리뷰 유형] for [대상]: [체크 1], [체크 2], and [체크 3].
예시:
"Code review guidelines for teams: security checks, performance analysis, and style consistency."
통합 스킬용
[통합/연결] [기술] with [접근 방식]: [기능 1] and [기능 2].
예시:
"Integrate Stripe payments with best practices: webhook handling and error recovery."
일반적인 실수
너무 모호함
문제: "Guidelines for better code." 개선: "Python code quality: PEP 8 style, type hints, and documentation standards."
너무 김
문제: 잘리는 300자 이상의 설명. 개선: 180자 미만 유지. 세부사항은 콘텐츠 섹션 사용.
맥락 없는 전문 용어
문제: "SOLID principles for DDD with CQRS patterns." 개선: "Clean architecture patterns: single responsibility, dependency injection, and domain modeling."
차별화 없음
문제: "React development guidelines." 개선: "React server components: streaming, suspense, and data fetching patterns."
키워드 전략
사용자가 검색할 수 있는 용어 포함:
| 카테고리 | 키워드 | |----------|----------| | 기술 | React, TypeScript, Python, AWS | | 도메인 | authentication, payments, analytics | | 작업 | review, testing, deployment | | 품질 | security, performance, accessibility |
설명 테스트하기
- 검색 테스트: 관련 용어로 검색하면 찾을 수 있나요?
- 스캔 테스트: 5초 안에 스킬을 이해할 수 있나요?
- 차별화 테스트: 유사한 스킬과 어떻게 다른가요?
- 행동 테스트: 이 스킬로 무엇을 할지 명확한가요?