Agent Skills — 영어 생산성 팩
이 저장소의 5개 스킬 중 4개가 OpenAgentSkill에 등록되어 있습니다. 예시: git-commit-message
일상적인 지식 작업을 위한 에이전트 스킬 모음입니다: 기술 문서 교정, 커밋 메시지 작성, 회의 노트를 회의록으로 변환, 코드 리뷰, 심층 조사 구조화. 무료로 사용 가능하며 가입이 필요 없습니다.
中文用户:另有《Agent Skills 中文实战包》v1(5 个 skill 中文版 + 中文安装指南 + 3 个中文实战案例),¥9.90 起一次买断 → 爱发电购买。本仓库英文原版永久免费(MIT)。
스킬
| 스킬 | 기능 |
|---|---|
tech-writing-proofread | 영어 기술 글쓰기 교정 — 오타, 문법, 구두점, 용어 일관성, 전문 용어, 구조 — 문서를 다시 작성하지 않고 항목별 원문 → 제안 → 이유 체크리스트를 반환합니다. |
git-commit-message | 스테이징된 변경사항으로부터 conventional-commit 메시지를 생성합니다: 유형 접두사 + 명령형 제목(50자 이하) + 이유를 설명하는 선택적 본문. |
meeting-notes | 원시 회의 노트를 구조화된 회의록으로 변환합니다: 결론 우선, 그 다음 결정 사항 / 액션 아이템 / 미해결 질문; 모든 액션 아이템에는 담당자와 마감일이 할당됩니다. |
code-review-checklist | 5축 코드 리뷰(정확성, 보안, 가독성, 성능, 테스트 커버리지)로 스타일 지적 대신 실행 가능한 코멘트를 제공합니다. |
deep-research-framework | 심층 조사 보고서를 위한 프레임워크: 질문 정의, 소스 계층화, 교차 검증, 결론 우선 보고서 작성 및 명시적 불확실성 표기. |
실제 동작 예시
원시 노트를 입력하면 구조화된 회의록이 출력됩니다 — meeting-notes 스킬의 작업 예시(전체 텍스트는 skills/meeting-notes/SKILL.md에 있습니다; 모든 스킬은 이와 같은 최소한의 예시를 제공합니다):
입력: "...James가 로그인 페이지가 너무 느리다고 했고, Maria가 캐시 계층을 추가하자고 제안했으며, 모두가 파일럿을 진행할 가치가 있다고 동의했습니다. 다음 주 수요일까지 제안서 초안을 작성하세요. 가격 전략은 아직 미정이며, 다음 번에 재무팀을 초대하세요..."
출력 — 결론: 로그인 페이지 속도 개선을 위해 캐시 계층을 파일럿으로 도입합니다. 가격 전략은 미정이며 재무팀과의 미팅이 필요합니다. 결정 사항: 로그인 페이지 성능을 위해 캐시 계층 도입 (전체 배포가 아닌 파일럿 우선). 액션 아이템: Maria — 캐싱 제안서 초안 작성, 다음 주 수요일까지
[날짜 확인 필요];[미할당]— 재무팀과 가격 논의 일정 조율[시간 미정]. 미해결 질문: 가격 전략 — 결정되지 않음; 액션 아이템 담당자가 재무팀과 별도 세션을 예약할 예정.
이 스킬이 하지 않는 일에 주목하세요: "다음 주 수요일"의 정확한 날짜를 추측하지 않으며, 노트에 언급되지 않은 담당자를 추정하지 않습니다 — 누락된 세부 사항은 표시되며 절대 조작되지 않습니다.
사용 방법
각 스킬은 skills/<이름>/SKILL.md에 위치합니다. SKILL.md 파일은 name과 description 필드로 시작합니다 — 설명은 에이전트 프레임워크가 일치하는 요청이 들어올 때 스킬을 표시할 수 있도록 작성되었습니다.
스킬을 사용하려면, 에이전트에게 원하는 작업을 알려주고(예: "이 README 교정해 줘" 또는 "이 노트를 회의록으로 바꿔 줘"), 에이전트가 자동으로 찾지 못할 경우 해당 SKILL.md를 가리키면 됩니다. 그러면 에이전트가 내부 워크플로를 따릅니다.
보안: 실행할 항목 없음
발행된 31,132개의 에이전트 스킬을 조사한 결과, 26.1%가 최소 하나의 보안 취약점을 포함했으며, 실행 가능한 스크립트를 번들로 제공하는 스킬은 명령어 전용 스킬보다 취약할 확률이 2.12배 더 높았습니다(커버리지).
이 팩은 의도적으로 명령어 전용으로 설계되었습니다:
- 각 스킬은 단일
SKILL.md— 일반 Markdown, 스크립트 없음, 바이너리 없음, 의존성 없음. - 다섯 스킬을 합쳐 283줄입니다. 설치하기 전에 모든 단어를 읽을 수 있습니다.
- 어떤 스킬도 자체적으로 자격 증명, 네트워크, 또는 파일에 접근하지 않습니다; 단지 에이전트에게 작업을 구조화하는 방법을 알려줄 뿐입니다.
SkillMD로 설치하기
다섯 스킬 모두 SkillMD에 등록되어 있습니다. 이름으로 원하는 스킬을 설치하세요:
npx skillmds@latest add alapha888/git-commit-message
npx skillmds@latest add alapha888/code-review-checklist
npx skillmds@latest add alapha888/meeting-notes
npx skillmds@latest add alapha888/deep-research-framework
npx skillmds@latest add alapha888/tech-writing-proofread
설계 원칙
- 에세이가 아닌 체크리스트. 모든 스킬은 에이전트가 단계별로 실행할 수 있는 워크플로이며, 최소한의 실행 가능한 예시를 포함합니다.
- 다시 쓰지 말고 교정하라. 교정 스킬은 결함을 지적하고 수정을 제안하지만, 당신의 어조를 절대 바꾸지 않습니다.
- 조작 금지. 회의록 및 연구 스킬은 이름, 날짜, 출처를 절대 조작하지 않습니다 — 누락된 정보는 표시되며 추측하지 않습니다.
- 포괄보다 실행 가능. 코드 리뷰는 10개 코멘트로 제한됩니다. 사소한 내용으로 가득한 리뷰는 실제 버그를 찾는 짧은 리뷰보다 나쁩니다.
라이선스
MIT. 자유롭게 사용, 포크, 수정하세요 — 저작자 표시는 권장되지만 필수는 아닙니다.
맞춤형 스킬 개발
맞춤형 스킬 / AI 워크플로 의뢰를 받습니다: 팀의 반복 워크플로를 위한 맞춤형 스킬(¥499부터), 또는 간단한 자동화 / 랜딩 페이지 구축(¥999부터). Afdian DM으로 연락주세요. 범위에 동의한 후, 30% 계약금은 이 Afdian 리스팅(¥150 / ¥299 티어)을 통해 지불됩니다.
Agent Skills Pro
고급 워크플로가 필요하신가요? Agent Skills Pro($39 일회성 결제)는 세 가지 유료 스킬 — multi-agent-decompose, codebase-map, release-notes — 을 추가하여 병렬 에이전트 조정, 익숙하지 않은 저장소 온보딩, 읽기 쉬운 릴리스 노트 작성에 도움을 줍니다. 위의 무료 팩은 계속 무료로 제공됩니다.