- 루쉰(魯迅): 중국 근대의 대표적인 작가이자 사상가로, 중국 사회의 낡은 관습과 사람들의 의식을 날카롭게 비판했다. 대표작으로 『아Q정전』, 『광인일기』 등이 있다.
- 아Q정전(阿Q正傳): 루쉰이 1921~1922년에 발표한 소설로, 주인공 아Q의 모습을 통해 신해혁명 전후 중국 사회의 문제와 당시 사람들의 정신적 태도를 풍자한다.
- 모옌(莫言): 중국 현대 작가로, 중국 농촌과 격변하는 사회를 독특한 상상력과 현실 묘사를 섞어 표현했다. 2012년 중국 작가 최초로 노벨문학상을 받았다.
- 중체서용(中體西用): 중국의 전통적인 사상·제도를 **근본(體)**으로 유지하면서 서양의 과학·기술을 **수단(用)**으로 받아들이자는 사상이다. 청나라 말기 양무운동의 대표적인 논리였다.
- 동도서기(東道西器): 동양의 전통적인 **도(道)**를 근본으로 삼고 서양의 과학·기술인 **기(器)**를 받아들이자는 생각이다. 중체서용과 매우 비슷한 의미로 사용된다.
- 공화국(共和國): 군주가 세습적으로 통치하는 군주제가 아니라, 국민 또는 국민이 선출한 대표가 국가의 통치에 참여하는 정치체제를 말한다. 중국에서는 신해혁명 이후 중화민국이 수립되면서 공화국 체제가 시작됐다.
- 신해혁명(辛亥革命): 1911년에 일어나 청나라를 무너뜨린 혁명으로, 중국의 마지막 왕조인 청나라가 붕괴하고 중화민국이 수립되는 계기가 되었다.
- 북양정부(北洋政府): 신해혁명 이후인 1912~1928년 중국 본토를 통치했던 정부로, 북양군벌 세력이 정치적 주도권을 장악했다. 위안스카이가 초대 대통령이었으며 이후 군벌 간의 정치적 경쟁이 이어졌다.
- 쑨원(孫文): 신해혁명을 이끈 중국의 혁명가이자 정치가로, 청나라를 무너뜨리고 공화국을 세우는 데 중요한 역할을 했다. **중화민국의 국부(國父)**로도 불린다.
- 위안스카이(袁世凱): 청나라 말기의 군인·정치가로, 신해혁명 과정에서 청나라의 마지막 황제 퇴위를 이끌어내는 데 관여했다. 이후 중화민국의 초대 임시대총통을 거쳐 정식 대총통이 되었고, 황제 복위를 시도하다가 반발 속에 실패했다.
전체 글
- 단어 2026.09.16
- 아Q정전 - res 2026.09.16
- Skills 양식대로 직접 작성 vs skill-creator로 만들기 2026.09.12
- 2609 notes 2026.09.11
- waveform 2026.09.06
- skill 추천 2026.09.06
단어
2026. 9. 16. 23:47
아Q정전 - res
2026. 9. 16. 23:18
좋아요. 이번에는 역사를 처음 배우는 사람도 『아Q정전』을 다시 읽으면 장면들이 연결되도록 설명해볼게요. 연도와 사건을 외우기보다는 **“루쉰이 대체 무엇을 보고 아Q를 만들었는가?”**에 초점을 맞추겠습니다.
1. 먼저 전체 상황: 중국은 왜 그렇게 혼란스러웠을까?
청나라 말기의 중국을 아주 단순화하면 이런 상황이었습니다.
전통적인 중국의 질서는 무너지고 있는데, 그것을 대신할 새로운 질서는 아직 제대로 자리 잡지 못한 상태였습니다.
19세기 중국은 서양 열강의 군사적·경제적 압력과 국내의 여러 반란을 겪었습니다. 특히 아편전쟁 이후 불평등조약이 이어지면서 청나라의 권위가 크게 흔들렸습니다.
그런데 여기서 중요한 것은 단순히
"중국이 서양에게 패했다."
가 아닙니다.
더 근본적인 문제는 사람들이 **"우리가 지금까지 믿어왔던 질서가 더 이상 제대로 작동하지 않는 것 아닌가?"**라는 상황에 놓였다는 것입니다.
이것이 루쉰이 바라본 중국의 큰 배경입니다.
2. 청나라가 무너지고 혁명이 일어납니다
1911년에 신해혁명 이 일어나고 청나라가 무너집니다.
그리고 중화민국 이 수립됩니다.
여기서 『아Q정전』을 이해하는 데 굉장히 중요한 포인트가 있습니다.
오늘날 우리는 보통 이렇게 생각하기 쉽습니다.
왕조가 무너짐 → 공화국 수립 → 새로운 시대 시작
하지만 실제 사람들의 삶에서는 그렇게 깔끔하게 끊어지지 않았습니다.
정치체제가 바뀌었다고 사람들의 사고방식까지 갑자기 바뀌는 것은 아니니까요.
그래서 『아Q정전』에서는 사람들이 '혁명'이라는 말을 듣고도 그것이 정확히 무엇을 의미하는지 제대로 이해하지 못하는 모습이 나옵니다.
이게 바로 아Q의 혁명 이야기를 이해하는 핵심입니다.
3. 그런데 아Q에게 '혁명'은 무엇일까?
여기서 작품을 다시 생각해봅시다.
아Q가 혁명이라는 말을 접했을 때 우리는 이런 질문을 할 수 있습니다.
"아Q는 혁명을 왜 지지하는 거지?"
그런데 자세히 보면 아Q가 혁명의 정치적 의미를 이해하고 있는 것은 아닙니다.
아Q에게 혁명은 어느 순간부터 자신이 힘을 얻을 수 있는 기회처럼 보입니다.
즉,
"혁명이란 새로운 정치체제와 사회질서를 만드는 것이다."
가 아니라
"혁명이 일어나면 나도 뭔가 얻을 수 있는 것 아닌가?"
에 가깝습니다.
이 차이가 굉장히 중요합니다.
루쉰이 보여주는 것은 단순히 무식한 아Q가 혁명을 잘못 이해했다는 이야기가 아닙니다.
오히려 이런 질문을 던지는 것입니다.
사회가 혁명을 외친다고 해서 그 사회의 구성원들이 실제로 새로운 인간이 되는가?
정치적 제도는 바뀌는데 사람들의 의식은 그대로라면 어떻게 될까요?
아Q는 바로 그 문제를 보여주는 인물입니다.
4. 두 번째로 알아야 할 것: '봉건사회'라는 말
여기서 흔히 『아Q정전』 해설에서 봉건사회라는 표현을 만나게 됩니다.
그런데 이걸 단순히
"옛날 중국 = 봉건사회"
라고 외우면 별로 도움이 안 됩니다.
소설을 읽을 때는 사람과 사람 사이의 위계질서를 보면 됩니다.
누가 누구보다 높은가?
누가 누구에게 복종해야 하는가?
누가 누구를 무시할 수 있는가?
그리고 중요한 것은 아Q가 그 질서의 피해자이면서 동시에 그 질서를 그대로 재생산한다는 점입니다.
아Q는 자신보다 강한 사람에게는 굴복합니다.
그런데 자신보다 약한 사람을 만나면 또 다른 방식으로 우위를 차지하려고 합니다.
이게 상당히 중요합니다.
아Q가 단순히 "나쁜 사람"이라서 그런 것이 아니라,
사람의 가치를 인간 자체가 아니라 사회적 위계에서 찾는 구조가 작품 전체에 깔려 있기 때문입니다.
그래서 아Q는 위에서 아래로 내려오는 억압을 받으면서도, 아래에 있는 사람에게 똑같은 방식으로 행동합니다.
5. 세 번째: 루쉰이 정말 비판하고 싶었던 것은 '무지'만이 아닙니다
이 부분이 『아Q정전』을 읽을 때 가장 중요하다고 생각합니다.
루쉰은 단순히
"중국 사람들은 무식하다."
라고 말하고 있는 것이 아닙니다.
그보다 훨씬 불편한 질문을 던집니다.
"왜 사람들은 현실을 똑바로 보지 못하는가?"
아Q는 계속해서 현실을 자기에게 유리한 방식으로 해석합니다.
맞았습니다.
→ 하지만 정신적으로는 내가 이겼다.
무시당했습니다.
→ 사실 저 사람들이 나를 두려워하는 것이다.
패배했습니다.
→ 그래도 내가 완전히 진 것은 아니다.
이것이 바로 흔히 말하는 정신승리법입니다.
여기서 중요한 건 "아Q가 멍청하다"가 아닙니다.
사람은 누구나 현실에서 패배하거나 자존심이 상하면 현실을 조금씩 왜곡하고 싶어질 수 있습니다.
루쉰은 그 심리를 극단적으로 확대해서 아Q라는 인물로 만든 것이라고 볼 수 있습니다.
6. 네 번째: '국민성'이라는 문제
루쉰을 이해하려면 당시 중국 지식인들이 고민했던 **'국민성 개조'**라는 문제를 알아두면 좋습니다.
루쉰은 중국이 단순히 군사력이나 기술이 부족해서 문제가 생긴다고만 생각하지 않았습니다.
그는 사람들이 현실을 인식하는 방식 자체에도 문제가 있다고 보았습니다.
그래서 루쉰의 소설에는 이런 인간들이 자주 등장합니다.
- 현실을 제대로 보지 못하는 사람
- 체면을 중요하게 생각하는 사람
- 강자에게 굴복하면서 약자를 억압하는 사람
- 자신의 실패를 인정하지 않는 사람
- 낡은 관습을 아무 생각 없이 반복하는 사람
아Q는 이런 문제를 한 사람의 캐릭터 안에 압축해 놓은 인물이라고 볼 수 있습니다.
그래서 제목이 단순히 "아Q 이야기"가 아니라 **『아Q정전』**이라는 것도 재미있습니다.
마치 한 개인의 전기처럼 보이지만, 실제로는 그 사람을 통해 당시 사회의 인간형을 보여주는 것입니다.
7. 다섯 번째: 그런데 루쉰 자신도 '중국인'입니다
이게 마지막으로 굉장히 중요합니다.
루쉰이 중국 사회를 비판한다고 해서
"나는 중국인들과 달라."
라고 밖에서 비판하는 것이 아닙니다.
루쉰 자신도 그 사회 안에 있습니다.
그래서 『아Q정전』의 풍자는 굉장히 독특합니다.
아Q를 보고 웃다가도 어느 순간 독자가 불편해집니다.
"그런데 나는 아Q와 정말 다른가?"
예를 들어 우리는 아Q가 자기합리화를 하는 모습을 보면서 웃습니다.
그런데 우리도 실패했을 때 스스로에게 이렇게 말할 때가 있죠.
"사실 내가 진 건 아니야."
"상대방이 운이 좋았던 거야."
"내가 제대로 했으면 내가 이겼어."
그렇다면 아Q의 정신승리는 완전히 낯선 인간의 모습일까요?
루쉰의 질문은 오히려 이것에 가깝습니다.
"아Q를 우습다고 생각하는 당신에게도 아Q적인 면이 있지 않은가?"
이 지점에 도달하면 『아Q정전』이 단순한 중국 근대사의 풍자소설을 넘어섭니다.
그러면 실제 소설의 장면들이 이렇게 연결됩니다
소설에서 보이는 것배경을 알고 보면
| 아Q가 모욕을 당하고 정신승리함 | 현실을 직시하지 못하는 인간의 심리 |
| 강자에게 약하고 약자에게 강함 | 위계적 사회질서의 내면화 |
| 혁명에 관심을 가짐 | 신해혁명이라는 시대적 격변 |
| 혁명을 자기 이익의 기회로 생각함 | 정치적 변화와 민중의 의식 사이의 괴리 |
| 주변 사람들이 혁명을 대하는 모습 | 혁명이 사회 구성원에게 실제로 무엇을 의미했는가라는 문제 |
| 아Q를 둘러싼 사람들의 태도 | 아Q 개인을 넘어 사회 전체에 대한 풍자 |
| 독자가 아Q를 보고 웃게 됨 | "그런데 우리는 아Q와 얼마나 다른가?"라는 자기반성 |
그리고 처음 질문으로 돌아가면
당신이 처음 읽고 **"작가가 말하려는 시대상이 잘 안 보였다"**고 느낀 이유는 꽤 명확합니다.
당신은 처음에 소설을 '아Q라는 사람에 대한 이야기'로 읽었기 때문입니다.
그건 아주 정상적인 1차 독해입니다.
그런데 역사적 배경을 알고 나면 독해의 초점이
아Q라는 사람 → 아Q를 만들어낸 사회 → 그 사회를 바라보는 루쉰 → 그 사회를 바라보는 독자인 나
로 계속 넓어집니다.
그래서 『아Q정전』은 배경을 알고 다시 읽을 때 갑자기 소설 속 인물들이 '상징'으로 보이기 시작하는 작품입니다.
특히 다시 읽는다면 아Q가 혁명을 접하고 혁명에 기대를 거는 부분과 마지막 처형 장면을 유심히 보세요. 그 두 부분을 중심으로 보면 왜 루쉰이 단순히 아Q라는 한심한 인간을 조롱하려고 이 소설을 쓴 것이 아닌지가 훨씬 선명해집니다.
Skills 양식대로 직접 작성 vs skill-creator로 만들기
2026. 9. 12. 01:39
Skills 양식대로 직접 작성 vs skill-creator로 만들기
직접 작성 (SKILL.md 양식 그대로)
어떤 것인가: YAML frontmatter(name, description)와 마크다운 본문으로 구성된 SKILL.md 파일을, 규칙(양식)만 참고해서 직접 작성하는 방식.
장점
- 빠르다 — 구조를 알면 몇 분 안에 초안 완성
- 의존성 없음 — 서브에이전트, 스크립트, 별도 도구 필요 없음
- 간단한 스킬(고정된 워크플로우, 짧은 지침)에는 충분
단점
- description 튜닝이 감(感)에 의존한다 — 이 설명 문구가 스킬이 언제 트리거될지를 결정하는 핵심인데, 직접 쓰면 "이 정도면 트리거되겠지"라는 추측에 그침
- 검증 없음 — 실제로 프롬프트에 잘 반응하는지, 오작동(과소/과다 트리거)하는지 테스트 안 하고 그냥 배포
- 반복 개선(iteration) 과정이 없어서, 실제 사용 중 문제가 드러나야 고치게 됨
skill-creator로 만들기
skill-creator는 SKILL.md를 "그냥 쓰는" 게 아니라, 작성 → 테스트 → 평가 → 개선을 반복하는 전체 워크플로우를 제공하는 스킬입니다.
핵심 차이점
항목 직접 작성 skill-creator
| 초안 작성 | 사용자가 직접 | 인터뷰 방식으로 요구사항 수집 후 작성 |
| 테스트 | 없음 | 실제 프롬프트 2-3개 이상으로 baseline(스킬 없이) vs with-skill 비교 실행 |
| 평가 | 주관적 감 | 정량적 assertion(검증 가능한 기준) + eval viewer로 사람이 직접 리뷰 |
| description 최적화 | 수동 추측 | run_loop.py로 20개 트리거 쿼리(should-trigger/should-not-trigger)를 만들어 자동으로 반복 개선, train/test 분리로 과적합 방지 |
| 반복 개선 | 사용자가 직접 다시 씀 | iteration-1, iteration-2... 디렉토리로 결과 누적, 피드백 기반 재작성 |
| 패키징 | 수동 | package_skill.py로 .skill 파일 생성, present_files로 전달 |
| 적합한 상황 | 간단하고 결과가 명확한 스킬 | 트리거 정확도가 중요하거나, 출력 품질을 반복적으로 다듬어야 하는 복잡한 스킬 |
요약
- 직접 작성은 "형식만 맞춰서 빨리 만드는" 방법 — 간단한 스킬이나 이미 워크플로우가 명확한 경우에 적합합니다.
- skill-creator는 "제대로 작동하는지 검증하면서 만드는" 방법 — 특히 description 트리거링(스킬이 언제 호출될지)과 출력 품질을 데이터 기반으로 개선하고 싶을 때 유용합니다. 대신 서브에이전트(Cowork/Claude Code 환경)나 스크립트 실행 환경이 있어야 전체 기능(baseline 비교, 벤치마크, description 최적화)을 다 쓸 수 있고, Claude.ai 웹처럼 서브에이전트가 없는 환경에서는 일부 단계(병렬 실행, 브라우저 리뷰어 등)를 건너뛰고 축소된 방식으로 동작합니다.
간단히 말하면: "양식 맞춰 쓰기"는 결과물(SKILL.md)을 만드는 방법이고, "skill-creator"는 그 결과물이 실제로 잘 작동하는지 검증하고 다듬는 프로세스입니다. 후자를 쓰면 전자도 결국 포함되지만, 테스트·평가·최적화가 더해집니다.
2609 notes
2026. 9. 11. 01:41
waveform
2026. 9. 6. 22:15
skill 추천
2026. 9. 6. 01:53
네. Claude Code에서 바로 설치해서 생산성을 체감하기 좋은 Skills 위주로 골라보면, 단순 프롬프트 모음보다 개발 workflow 자체를 자동화하는 Skill을 먼저 넣는 게 좋습니다.
현재 Claude Code의 Skill은 SKILL.md를 진입점으로 하는 구조이고, 개인 전역은 ~/.claude/skills/<skill>/SKILL.md, 프로젝트 전용은 .claude/skills/<skill>/SKILL.md에 둘 수 있습니다. 또한 공식 플러그인에서 제공하는 Skill도 있습니다. GitHub+1
제가 추천하는 우선순위
우선스킬용도생산성 체감추천도
| 1 | feature-dev | 기능 개발 전체 workflow | ⭐⭐⭐⭐⭐ | ★★★★★ |
| 2 | commit-commands | commit / push / PR 자동화 | ⭐⭐⭐⭐⭐ | ★★★★★ |
| 3 | frontend-design | React/웹 UI 구현 품질 향상 | ⭐⭐⭐⭐ | ★★★★★ |
| 4 | discovery:explore | 코드베이스 분석·탐색 | ⭐⭐⭐⭐⭐ | ★★★★★ |
| 5 | plugin-dev | Skill/Hook/MCP 직접 제작 | ⭐⭐⭐⭐ | ★★★★☆ |
| 6 | skill-compliance-checklist | Skill 품질 검증 | ⭐⭐⭐ | ★★★★☆ |
| 7 | use-your-skills | 필요한 Skill을 빠뜨리지 않게 관리 | ⭐⭐⭐ | ★★★★☆ |
1. feature-dev — 기능 개발 Workflow
가장 먼저 추천합니다.
기능 하나를 구현할 때 Claude가 바로 코드를 찍는 대신, 코드베이스 탐색 → 설계 → 구현 → 검증의 흐름으로 작업하게 만드는 Skill입니다.
특히 이런 요청에 좋습니다.
새로운 결제 기능 추가해줘
회원가입 기능 리팩터링해줘
이 API에 pagination 추가해줘
공식 feature-dev 플러그인에 포함되어 있습니다. Anthropic의 공식 Skill 목록에서도 end-to-end feature development 용도로 안내하고 있습니다. GitHub
설치
Claude Code에서:
/plugin install feature-dev
또는 공식 저장소:
Anthropic claude-plugins-official
생산성: ⭐⭐⭐⭐⭐
개인적으로는 Claude Code를 "코딩 챗봇"이 아니라 개발 에이전트로 쓰고 싶다면 1순위입니다.
2. commit-commands — Git 작업 자동화
개발하다 보면 이런 작업을 계속 하게 됩니다.
git diff
git status
git add
commit message 작성
commit
push
PR 생성
이걸 Skill로 묶어놓으면 상당히 편합니다.
공식 플러그인에는 다음 workflow가 들어 있습니다.
- commit
- commit-push-pr
즉,
/commit
또는
/commit-push-pr
같은 식으로 사용할 수 있습니다. GitHub
설치
/plugin install commit-commands
공식 저장소:
Anthropic claude-plugins-official
생산성: ⭐⭐⭐⭐⭐
특히 Claude Code로 하루 종일 개발하는 사람에게 체감이 큽니다.
3. frontend-design — UI 개발
React / Next.js / Vue 등의 프론트엔드를 Claude Code로 만들고 있다면 강력 추천합니다.
일반적인 Claude에게:
로그인 페이지 만들어줘
라고 하면 흔히 볼 수 있는 AI 스타일의 평범한 UI가 나올 수 있는데, frontend-design은 시각적 완성도와 디자인 방향을 고려한 UI 구현을 목표로 합니다.
Anthropic 공식 Skill 설명에서도 "polished UI components"와 generic AI aesthetics를 피하는 것을 목적으로 명시하고 있습니다. GitHub
설치
/plugin install frontend-design
공식 저장소:
Anthropic claude-plugins-official
생산성: ⭐⭐⭐⭐☆
특히 추천하는 경우
- Next.js
- React
- Tailwind
- SaaS dashboard
- Admin UI
- Landing page
- 모바일 웹
- 컴포넌트 디자인
4. discovery:explore — 코드베이스 탐색
이건 상당히 마음에 드는 Skill입니다.
Claude Code에서 기존 프로젝트를 이해하는 시간을 줄여줍니다.
예를 들어:
이 프로젝트에서 인증이 어떻게 구현되어 있는지 찾아줘
결제 로직의 dependency를 추적해줘
이 기능을 수정하려면 어떤 파일을 건드려야 하는지 조사해줘
같은 작업에 적합합니다.
실제 Skill은 코드베이스를 탐색하고, dependency와 테스트 및 Git history까지 살펴보는 workflow를 제공합니다. GitHub
다운로드
claude-code-plugins — discovery/explore
프로젝트에 가져와서:
.claude/skills/discovery-explore/SKILL.md
형태로 설치할 수 있습니다.
생산성: ⭐⭐⭐⭐⭐
왜 중요한가?
Claude Code에게 바로:
이거 수정해
라고 하는 것보다,
먼저 코드베이스를 탐색하고 관련 파일과 dependency를 정리해줘.
그 다음 수정해.
라는 workflow가 버그와 잘못된 수정 가능성을 크게 줄여줍니다.
5. plugin-dev — Skill을 직접 만드는 Skill
Claude Code를 어느 정도 사용하다 보면 결국 여기로 갑니다.
"내가 반복하는 작업을 Skill로 만들자."
예를 들어:
/create-api
/review-security
/test-feature
/deploy-staging
/create-pr
/check-db-migration
같은 것을 만들 수 있습니다.
Anthropic 공식 plugin-dev에는 다음과 같은 Skill이 들어 있습니다.
- skill-development
- hook-development
- command-development
- agent-development
- mcp-integration
- plugin-structure
즉 Claude Code 자체를 확장하는 방법을 Claude에게 가르쳐주는 Skill이라고 보면 됩니다. GitHub
다운로드
Anthropic claude-code plugin-dev
생산성: ⭐⭐⭐⭐☆
6. skill-compliance-checklist — Skill 검사
이건 Skill을 많이 만들 사람에게 추천합니다.
내가 만든:
.claude/skills/my-skill/SKILL.md
이 제대로 작성됐는지 검사합니다.
검사 대상에는:
- frontmatter
- description
- directory structure
- progressive disclosure
- error handling
- testing
- Skill 구조
등이 포함됩니다. GitHub
다운로드
skill-compliance-checklist GitHub
생산성: ⭐⭐⭐☆☆
Skill을 1~2개만 쓸 거라면 굳이 필요 없지만, 자신만의 Skill library를 구축한다면 상당히 유용합니다.
7. use-your-skills — Skill 사용 관리
조금 재미있는 Skill입니다.
Skill을 설치해 놓고도 Claude가 매번 일반적인 방법으로 작업하는 경우가 있습니다.
이 Skill은 현재 사용 가능한 Skill을 확인하고:
"이 작업에 사용할 수 있는 Skill이 있는가?"
를 먼저 판단하도록 유도합니다.
즉 Skill을 설치해놓고 안 쓰는 문제를 줄이는 역할입니다. GitHub
다운로드
melodic-software claude-code-plugins
생산성: ⭐⭐⭐☆☆
Skill을 10개 이상 설치할 생각이라면 추천합니다.
제가 실제로 구성한다면
처음부터 20~30개 설치하지 않는 걸 추천합니다.
기본 개발자 세트
feature-dev
commit-commands
discovery:explore
frontend-design
이 4개부터 시작합니다.
그리고 Claude Code를 사용하면서 반복 작업이 생기면:
내가 계속 반복하는 작업
↓
SKILL.md로 추출
↓
.claude/skills/
↓
나만의 개발 workflow
로 발전시키는 방식이 좋습니다.
Claude Code의 Skill은 단순 Markdown 하나만 넣어도 되고, 필요하면 references/, scripts/, assets/ 등을 함께 넣을 수 있습니다. 상세 문서는 필요할 때만 읽도록 분리하는 progressive disclosure 방식도 지원합니다. GitHub
특히 추천하는 "개인 생산성 Skill" 조합
제가 Claude Code를 직접 세팅한다면 다음 구조로 만들겠습니다.
~/.claude/skills/
├── explore/
│ └── SKILL.md
│
├── feature-dev/
│ └── SKILL.md
│
├── code-review/
│ └── SKILL.md
│
├── test/
│ └── SKILL.md
│
├── commit/
│ └── SKILL.md
│
├── security-review/
│ └── SKILL.md
│
├── database-migration/
│ └── SKILL.md
│
└── deploy/
└── SKILL.md
특히 **code-review + test + security-review + deploy**는 프로젝트에 맞춰 직접 만드는 것도 강력합니다.
중요한 점: 아무 Skill이나 다운로드하지 마세요
Skill은 단순 문서가 아니라 Claude Code가 실행할 수 있는 명령/도구 사용 지침을 포함할 수 있습니다.
따라서 GitHub에서 가져올 때는 SKILL.md뿐 아니라 scripts/ 같은 파일도 확인하는 것이 좋습니다. 실제 Claude Code Skill 가이드에서도 Skill이 shell 권한으로 실행되는 지침을 포함할 수 있으므로 신뢰할 수 있는 출처의 Skill만 설치하고 내용을 검토할 것을 권장합니다. GitHub
⭐ 최종 추천 순위
바로 설치한다면:
- 🥇 feature-dev — 기능 개발
- 🥈 commit-commands — Git/PR
- 🥉 discovery:explore — 코드베이스 탐색
- frontend-design — 프론트엔드
- plugin-dev — 나만의 Skill 제작
- skill-compliance-checklist — Skill 검증
- use-your-skills — Skill 활용 관리
그리고 Claude Code를 제대로 생산성 도구로 만들려면 "남이 만든 Skill 30개 설치"보다 "핵심 Skill 4~5개 + 내 프로젝트 전용 Skill 5개" 구조가 훨씬 좋습니다.
원하시면 다음 단계로 GitHub에서 실제로 다운로드 가능한 Claude Code Skill 20~30개를 더 찾아서 개발 / 코드리뷰 / 테스트 / 보안 / Git / 문서 / DB / 프론트엔드 / DevOps / AI 카테고리별로 정리하고, 각 Skill마다 GitHub 주소 + 설치 명령어 + 사용 예시 + 추천 점수까지 붙여드릴 수 있습니다. GitHub
출처
50s 동안 처리함
좋습니다. 이번에는 실제로 GitHub에서 SKILL.md를 확인할 수 있고 Claude Code에 가져와 쓸 수 있는 것을 기준으로 다시 정리했습니다.
특히 wshobson/agents는 현재 183개의 Agent Skills / 51개 plugin을 제공하고, GitHub CLI의 gh skill install wshobson/agents <skill> 또는 npx skills add wshobson/agents --skill <skill> 방식의 개별 설치를 공식 문서에 안내하고 있습니다. GitHub
또한 Anthropic 공식 claude-plugins-official과 anthropics/skills, obra/superpowers 등의 실제 GitHub 저장소도 교차 확인했습니다. GitHub+2
점수 기준: 5점 = 일반적인 개발자가 거의 매일 써도 되는 수준 / 4점 = 특정 기술스택에서 매우 유용 / 3점 = 특정 상황에서 유용
주의: Skill은 실행 스크립트나 외부 명령을 포함할 수 있으므로 설치 전 SKILL.md와 scripts/를 한 번 확인하는 것을 권장합니다. Anthropic도 Skill을 SKILL.md + scripts/references/assets 구조로 설명하고 있습니다. GitHub+1
1. 개발 / 아키텍처 — 10개
wshobson/agents의 Backend Development / Developer Essentials 계열에서 골랐습니다. GitHub
#Skill용도생산성바로 쓰는 예시
| 1 | api-design-principles | REST/GraphQL API 설계 | ⭐⭐⭐⭐⭐ | REST API 구조를 이 Skill 기준으로 설계해줘 |
| 2 | architecture-patterns | Clean/Hexagonal/DDD | ⭐⭐⭐⭐⭐ | 현재 구조를 Hexagonal Architecture로 분석해줘 |
| 3 | microservices-patterns | MSA 서비스 경계/이벤트 | ⭐⭐⭐⭐ | 이 모놀리스를 MSA 관점에서 분해해줘 |
| 4 | workflow-orchestration-patterns | Temporal 기반 workflow | ⭐⭐⭐⭐ | 이 결제 프로세스를 Temporal workflow로 설계해줘 |
| 5 | event-store-design | Event Store 설계 | ⭐⭐⭐⭐ | 이벤트 저장소 schema를 설계해줘 |
| 6 | cqrs-implementation | CQRS 구현 | ⭐⭐⭐⭐ | 주문 시스템을 CQRS로 바꿔줘 |
| 7 | projection-patterns | Event projection/read model | ⭐⭐⭐⭐ | 이 이벤트에서 read model을 만들어줘 |
| 8 | saga-orchestration | 분산 트랜잭션/Saga | ⭐⭐⭐⭐ | MSA 결제 Saga를 설계해줘 |
| 9 | error-handling-patterns | 예외/Result/Graceful degradation | ⭐⭐⭐⭐⭐ | 에러 처리를 일관된 패턴으로 리팩터링해줘 |
| 10 | monorepo-management | Turborepo/Nx/pnpm | ⭐⭐⭐⭐ | 이 monorepo 구조를 분석해줘 |
GitHub / 설치: 각 항목은 wshobson/agents에서 SKILL.md를 제공하며 다음처럼 설치합니다. GitHub
gh skill install wshobson/agents api-design-principles
gh skill install wshobson/agents architecture-patterns
gh skill install wshobson/agents microservices-patterns
나머지도 동일한 형식으로:
gh skill install wshobson/agents <skill-name>
wshobson/agents GitHub
2. 코드 리뷰 / 코드 이해 — 10개
이 영역은 Claude Code를 실제 개발에 사용하는 경우 가장 중요하게 추천하는 영역입니다. 특히 code-review-excellence, debugging-strategies, multi-agent review 계열이 좋습니다. GitHub
#Skill용도생산성사용 예시
| 11 | code-review-excellence | 체계적인 코드 리뷰 | ⭐⭐⭐⭐⭐ | 현재 변경사항을 심층 리뷰해줘 |
| 12 | debugging-strategies | 원인 추적/디버깅 | ⭐⭐⭐⭐⭐ | 이 버그의 root cause를 찾아줘 |
| 13 | multi-reviewer-patterns | 여러 관점의 병렬 코드 리뷰 | ⭐⭐⭐⭐⭐ | 보안/성능/품질 관점에서 병렬 리뷰해줘 |
| 14 | parallel-debugging | 여러 가설을 병렬 검증 | ⭐⭐⭐⭐⭐ | 이 장애 원인을 여러 가설로 조사해줘 |
| 15 | parallel-feature-development | 병렬 기능 개발 | ⭐⭐⭐⭐ | 이 기능을 여러 작업으로 나눠 병렬 개발해줘 |
| 16 | task-coordination-strategies | Agent task 분해 | ⭐⭐⭐⭐⭐ | 이 작업을 agent task graph로 분해해줘 |
| 17 | team-composition-patterns | Agent 팀 구성 | ⭐⭐⭐⭐ | 이 문제에 최적인 agent 팀을 구성해줘 |
| 18 | team-communication-protocols | Agent 간 통신/협업 | ⭐⭐⭐⭐ | agent들이 충돌 없이 작업하도록 구성해줘 |
| 19 | before-you-build | 구현 전 위험 검토 | ⭐⭐⭐⭐⭐ | 코딩 전에 이 기능의 위험을 검토해줘 |
| 20 | evaluation-methodology | AI/plugin 품질 평가 | ⭐⭐⭐⭐ | 이 Skill의 품질 평가 기준을 만들어줘 |
설치
gh skill install wshobson/agents code-review-excellence
gh skill install wshobson/agents multi-reviewer-patterns
gh skill install wshobson/agents parallel-debugging
코드 리뷰 Skill 저장소
참고로 Anthropic 공식 feature-dev도 코드베이스 탐색 → 설계 → 구현 → 3개 관점의 code reviewer → 수정이라는 7단계 workflow를 제공합니다. 그래서 위 Skill들과 함께 사용하면 좋습니다. GitHub+1
3. 테스트 — 10개
wshobson/agents에는 Python/JavaScript/E2E/Temporal/Web3/Shell 등 테스트 관련 Skill이 꽤 잘 갖춰져 있습니다. GitHub
#Skill용도점수사용 예시
| 21 | e2e-testing-patterns | Playwright/Cypress E2E | ⭐⭐⭐⭐⭐ | 핵심 사용자 flow E2E 테스트를 만들어줘 |
| 22 | temporal-python-testing | Temporal 테스트 | ⭐⭐⭐⭐ | 이 workflow의 pytest를 만들어줘 |
| 23 | python-testing-patterns | pytest/mock/fixture | ⭐⭐⭐⭐⭐ | 이 모듈의 pytest를 작성해줘 |
| 24 | javascript-testing-patterns | Jest/Vitest/Testing Library | ⭐⭐⭐⭐⭐ | React 테스트를 작성해줘 |
| 25 | web3-testing | Hardhat/Foundry | ⭐⭐⭐ | 이 smart contract 테스트를 만들어줘 |
| 26 | bats-testing-patterns | Bash 테스트 | ⭐⭐⭐ | 이 shell script에 Bats 테스트 추가해줘 |
| 27 | webapp-testing | 실제 웹앱 Playwright 검증 | ⭐⭐⭐⭐⭐ | 브라우저에서 이 기능을 테스트해줘 |
| 28 | testing | 테스트 workflow/검증 | ⭐⭐⭐⭐ | 변경사항에 필요한 테스트를 찾아줘 |
| 29 | diagnose | 실패 테스트 원인 분석 | ⭐⭐⭐⭐⭐ | 실패한 테스트의 원인을 찾아 수정해줘 |
| 30 | test-driven-development | TDD workflow | ⭐⭐⭐⭐⭐ | TDD 방식으로 이 기능을 구현해줘 |
diagnose는 Melodic Software의 실제 Skill로, 실패를 무작정 재실행하지 않고 분류 → root cause → reproduce → isolate → fix → retest → regression 순으로 처리합니다. GitHub
gh skill install wshobson/agents python-testing-patterns
gh skill install wshobson/agents javascript-testing-patterns
gh skill install wshobson/agents e2e-testing-patterns
webapp-testing은 Anthropic의 공개 Skills 생태계에도 실제 Skill로 존재하는 것으로 확인됩니다. GitHub
4. 보안 — 10개
보안 쪽은 단순 "취약점 찾아줘"보다 위협 모델링 → 요구사항 → mitigation까지 연결하는 Skill을 추천합니다. wshobson/agents의 Security Scanning 계열이 이 구조입니다. GitHub
#Skill용도점수사용 예시
| 31 | sast-configuration | SAST 설정 | ⭐⭐⭐⭐⭐ | 이 프로젝트에 SAST를 구성해줘 |
| 32 | stride-analysis-patterns | STRIDE threat modeling | ⭐⭐⭐⭐⭐ | 이 시스템을 STRIDE로 분석해줘 |
| 33 | attack-tree-construction | 공격 경로 분석 | ⭐⭐⭐⭐ | 이 인증 시스템의 attack tree를 만들어줘 |
| 34 | security-requirement-extraction | 보안 요구사항 도출 | ⭐⭐⭐⭐⭐ | 위협 모델에서 security requirements를 뽑아줘 |
| 35 | threat-mitigation-mapping | 위협 → 대응책 매핑 | ⭐⭐⭐⭐⭐ | 각 위협에 대응책을 매핑해줘 |
| 36 | auth-implementation-patterns | JWT/OAuth/RBAC | ⭐⭐⭐⭐⭐ | 현재 인증 구현을 보안 관점에서 검토해줘 |
| 37 | secrets-management | Vault/AWS Secrets | ⭐⭐⭐⭐⭐ | secret 관리 구조를 개선해줘 |
| 38 | k8s-security-policies | Kubernetes RBAC/NetworkPolicy | ⭐⭐⭐⭐ | K8s 보안 정책을 만들어줘 |
| 39 | solidity-security | Smart Contract 보안 | ⭐⭐⭐ | 이 Solidity 코드를 audit해줘 |
| 40 | pci-compliance | PCI DSS | ⭐⭐⭐ | 결제 시스템의 PCI 요구사항을 검토해줘 |
설치 예:
gh skill install wshobson/agents sast-configuration
gh skill install wshobson/agents stride-analysis-patterns
gh skill install wshobson/agents security-requirement-extraction
보안 Skill 원본 저장소
5. Git / GitHub — 10개
Git workflow는 Claude Code에서 투자 대비 효과가 가장 큽니다.
#Skill용도점수사용 예시
| 41 | git-advanced-workflows | rebase/cherry-pick/bisect/worktree | ⭐⭐⭐⭐⭐ | 이 브랜치를 안전하게 rebase해줘 |
| 42 | github-actions-templates | GitHub Actions | ⭐⭐⭐⭐⭐ | CI workflow를 만들어줘 |
| 43 | gitlab-ci-patterns | GitLab CI | ⭐⭐⭐⭐ | GitLab pipeline을 만들어줘 |
| 44 | gitops-workflow | ArgoCD/Flux GitOps | ⭐⭐⭐⭐⭐ | 이 배포를 GitOps로 바꿔줘 |
| 45 | deployment-pipeline-design | CI/CD pipeline 설계 | ⭐⭐⭐⭐⭐ | production pipeline을 설계해줘 |
| 46 | changelog-automation | Conventional Commit 기반 changelog | ⭐⭐⭐⭐ | 이번 release changelog 만들어줘 |
| 47 | track-management | feature/bug/refactor tracking | ⭐⭐⭐⭐ | 이 기능을 track으로 관리해줘 |
| 48 | workflow-patterns | TDD/commit/verification | ⭐⭐⭐⭐⭐ | 검증 checkpoint를 포함한 workflow를 만들어줘 |
| 49 | block-no-verify-hook | pre-commit 우회 방지 | ⭐⭐⭐⭐ | --no-verify 사용을 막아줘 |
| 50 | github setup | gh CLI/auth/config 확인 | ⭐⭐⭐⭐ | GitHub CLI 상태를 점검해줘 |
git-advanced-workflows는 rebase, cherry-pick, bisect, worktree, reflog 등을 다룹니다. GitHub
그리고 공식 Anthropic plugin에는 Git용 commit과 commit-push-pr Skill이 따로 있습니다. GitHub
/plugin install commit-commands
사용:
/commit
/commit-push-pr
Anthropic 공식 commit-commands
6. 문서 / API / 지식 — 10개
#Skill용도점수사용 예시
| 51 | openapi-spec-generation | OpenAPI 3.1 생성 | ⭐⭐⭐⭐⭐ | 이 API에서 OpenAPI spec을 만들어줘 |
| 52 | architecture-decision-records | ADR 작성 | ⭐⭐⭐⭐⭐ | 이번 아키텍처 결정을 ADR로 작성해줘 |
| 53 | hads | AI-friendly 문서화 | ⭐⭐⭐⭐ | 이 문서를 HADS 형식으로 바꿔줘 |
| 54 | grounded-vault | source-linked knowledge base | ⭐⭐⭐⭐ | 이 자료를 근거 기반 knowledge vault로 정리해줘 |
| 55 | changelog-automation | 변경 이력 | ⭐⭐⭐⭐ | release note를 만들어줘 |
| 56 | data-storytelling | 데이터를 이야기 구조로 변환 | ⭐⭐⭐⭐ | 이 분석 결과를 임원 보고용으로 바꿔줘 |
| 57 | postmortem-writing | 장애 회고 | ⭐⭐⭐⭐⭐ | 이번 장애를 blameless postmortem으로 작성해줘 |
| 58 | incident-runbook-templates | 운영 Runbook | ⭐⭐⭐⭐⭐ | 이 장애 유형의 runbook을 만들어줘 |
| 59 | on-call-handoff-patterns | 인수인계 문서 | ⭐⭐⭐⭐ | 이번 on-call 내용을 정리해줘 |
| 60 | avoid-ai-writing | AI 냄새 나는 문장 개선 | ⭐⭐⭐ | 이 문서를 사람이 쓴 것처럼 다듬어줘 |
hads는 실제 SKILL.md가 확인되며 인간과 AI가 모두 읽기 좋은 기술문서를 만드는 데 초점을 둡니다. GitHub
7. DB / 데이터 — 10개
#Skill용도점수사용 예시
| 61 | sql-optimization-patterns | SQL/Index/EXPLAIN | ⭐⭐⭐⭐⭐ | 이 SQL의 성능을 개선해줘 |
| 62 | postgresql-table-design | PostgreSQL schema | ⭐⭐⭐⭐⭐ | 이 DB schema를 리뷰해줘 |
| 63 | database-migration | zero-downtime migration | ⭐⭐⭐⭐⭐ | 이 migration을 무중단으로 만들어줘 |
| 64 | event-store-design | Event Store | ⭐⭐⭐⭐ | event store 구조를 설계해줘 |
| 65 | projection-patterns | read model | ⭐⭐⭐⭐ | projection 구조를 설계해줘 |
| 66 | dbt-transformation-patterns | dbt | ⭐⭐⭐⭐ | dbt 모델과 테스트를 만들어줘 |
| 67 | data-quality-frameworks | 데이터 품질 | ⭐⭐⭐⭐ | 데이터 validation을 설계해줘 |
| 68 | spark-optimization | Apache Spark | ⭐⭐⭐⭐ | Spark job을 최적화해줘 |
| 69 | airflow-dag-patterns | Airflow DAG | ⭐⭐⭐⭐ | 이 데이터 pipeline을 Airflow DAG로 만들어줘 |
| 70 | cqrs-implementation | read/write DB 분리 | ⭐⭐⭐⭐ | CQRS DB 구조를 설계해줘 |
특히 sql-optimization-patterns, postgresql-table-design, database-migration 세 개는 일반적인 웹 백엔드 개발자에게 추천도가 높습니다. GitHub
8. 프론트엔드 / UI — 10개
#Skill용도점수사용 예시
| 71 | react-modernization | React 현대화 | ⭐⭐⭐⭐⭐ | 이 React 코드를 modern React로 바꿔줘 |
| 72 | react-state-management | Zustand/Jotai/React Query | ⭐⭐⭐⭐⭐ | 상태관리를 React Query + Zustand로 정리해줘 |
| 73 | nextjs-app-router-patterns | Next.js App Router/RSC | ⭐⭐⭐⭐⭐ | 이 페이지를 App Router 방식으로 만들어줘 |
| 74 | tailwind-design-system | Tailwind Design System | ⭐⭐⭐⭐⭐ | Tailwind 기반 design system을 만들어줘 |
| 75 | design-system-patterns | 디자인 시스템 | ⭐⭐⭐⭐⭐ | 컴포넌트 디자인 시스템을 설계해줘 |
| 76 | responsive-design | 반응형 UI | ⭐⭐⭐⭐⭐ | 모바일/desktop 반응형으로 바꿔줘 |
| 77 | interaction-design | animation/micro-interaction | ⭐⭐⭐⭐ | 이 버튼 interaction을 개선해줘 |
| 78 | visual-design-foundations | typography/color/spacing | ⭐⭐⭐⭐ | 이 UI의 visual hierarchy를 개선해줘 |
| 79 | accessibility-compliance | WCAG/ARIA | ⭐⭐⭐⭐⭐ | 이 UI의 accessibility를 검사해줘 |
| 80 | web-component-design | Web Components | ⭐⭐⭐⭐ | 재사용 가능한 Web Component로 만들어줘 |
여기에 Anthropic 공식 frontend-design을 강력 추천합니다. 공식 문서상 React/Vue/Angular 등의 UI에서 generic AI aesthetics를 피하고 production-grade UI를 만드는 용도입니다. GitHub+1
/plugin install frontend-design
frontend-design 공식 Skill
9. DevOps / Cloud / Observability — 10개
#Skill용도점수사용 예시
| 81 | k8s-manifest-generator | Kubernetes YAML | ⭐⭐⭐⭐⭐ | production용 Deployment/Service를 만들어줘 |
| 82 | helm-chart-scaffolding | Helm Chart | ⭐⭐⭐⭐⭐ | 이 서비스를 Helm chart로 만들어줘 |
| 83 | gitops-workflow | ArgoCD/Flux | ⭐⭐⭐⭐⭐ | GitOps 구조를 설계해줘 |
| 84 | terraform-module-library | Terraform module | ⭐⭐⭐⭐⭐ | 재사용 가능한 Terraform module을 만들어줘 |
| 85 | multi-cloud-architecture | AWS/Azure/GCP | ⭐⭐⭐⭐ | 멀티클라우드 구조를 설계해줘 |
| 86 | istio-traffic-management | Istio routing/canary | ⭐⭐⭐⭐ | Istio canary deployment을 구성해줘 |
| 87 | mtls-configuration | mTLS/zero-trust | ⭐⭐⭐⭐ | 서비스간 mTLS를 설계해줘 |
| 88 | service-mesh-observability | tracing/metrics | ⭐⭐⭐⭐ | service mesh observability를 구축해줘 |
| 89 | prometheus-configuration | Prometheus | ⭐⭐⭐⭐ | Prometheus monitoring을 구성해줘 |
| 90 | grafana-dashboards | Grafana dashboard | ⭐⭐⭐⭐ | 이 metric을 Grafana dashboard로 만들어줘 |
이 계열은 실제 wshobson/agents 문서에서 Kubernetes, CI/CD, Cloud Infrastructure, Observability plugin으로 분류되어 있습니다. GitHub
10. AI / LLM / Agent — 10개
Claude Code를 단순 coding assistant가 아니라 AI application 개발 도구로 사용하는 경우 추천합니다.
#Skill용도점수사용 예시
| 91 | langchain-architecture | LangChain Agent 구조 | ⭐⭐⭐⭐ | LangChain agent architecture를 설계해줘 |
| 92 | prompt-engineering-patterns | 고급 prompting | ⭐⭐⭐⭐⭐ | 이 prompt를 production용으로 개선해줘 |
| 93 | rag-implementation | RAG | ⭐⭐⭐⭐⭐ | 이 문서 검색 시스템을 RAG로 만들어줘 |
| 94 | llm-evaluation | LLM evaluation | ⭐⭐⭐⭐⭐ | LLM 응답 평가 시스템을 만들어줘 |
| 95 | embedding-strategies | embedding/chunking | ⭐⭐⭐⭐ | 문서 embedding 전략을 설계해줘 |
| 96 | similarity-search-patterns | ANN/vector search | ⭐⭐⭐⭐ | semantic search를 설계해줘 |
| 97 | vector-index-tuning | HNSW/IVF | ⭐⭐⭐⭐ | vector index를 최적화해줘 |
| 98 | hybrid-search-implementation | Vector + keyword | ⭐⭐⭐⭐⭐ | hybrid search를 구현해줘 |
| 99 | ml-pipeline-workflow | MLOps pipeline | ⭐⭐⭐⭐ | 모델 training/deployment pipeline을 만들어줘 |
| 100 | claude-api | Anthropic API/SDK | ⭐⭐⭐⭐⭐ | 이 Anthropic API 코드를 최신 방식으로 고쳐줘 |
마지막 claude-api는 Anthropic 공식 Skills repository의 실제 Skill이며 Claude API/SDK, prompt caching, tool use, model migration 등을 다룹니다. GitHub
설치:
gh skill install wshobson/agents prompt-engineering-patterns
gh skill install wshobson/agents rag-implementation
gh skill install wshobson/agents llm-evaluation
claude-api는 Anthropic 공식 저장소의 것을 사용하는 것을 추천합니다.
Anthropic Skills — claude-api
설치를 한 번에 시작하려면
100개를 전부 설치하는 것은 추천하지 않습니다.
제가 실제 Claude Code 환경을 구성한다면 우선 다음 15개 정도만 넣겠습니다.
# Architecture / Development
gh skill install wshobson/agents architecture-patterns
gh skill install wshobson/agents api-design-principles
# Code Review / Debug
gh skill install wshobson/agents code-review-excellence
gh skill install wshobson/agents debugging-strategies
gh skill install wshobson/agents multi-reviewer-patterns
# Testing
gh skill install wshobson/agents python-testing-patterns
gh skill install wshobson/agents javascript-testing-patterns
gh skill install wshobson/agents e2e-testing-patterns
# Security
gh skill install wshobson/agents auth-implementation-patterns
gh skill install wshobson/agents sast-configuration
# Git
gh skill install wshobson/agents git-advanced-workflows
# Database
gh skill install wshobson/agents sql-optimization-patterns
gh skill install wshobson/agents database-migration
# AI
gh skill install wshobson/agents prompt-engineering-patterns
gh skill install wshobson/agents rag-implementation
그리고 공식 Skill:
/plugin install feature-dev
/plugin install commit-commands
/plugin install frontend-design
공식 plugin 목록에는 이 세 가지가 각각 feature development / Git / frontend 핵심 workflow로 등록되어 있습니다. GitHub
⭐ 마지막으로 특히 중요한 Skill — 별도 추천
여기부터는 요청하신 PPT 생성 / 코드 검토 / 코드 시각화 / 코드 동작 이해에 초점을 맞춰 다시 추렸습니다.
1. 🥇 코드 검토: code-review-excellence
가장 먼저 설치할 만한 것 중 하나입니다.
gh skill install wshobson/agents code-review-excellence
사용:
현재 branch의 변경사항을 코드 리뷰해줘.
버그, 보안, 성능, 유지보수성, 테스트 부족을 심각도별로 찾아줘.
특히 더 강하게 하고 싶다면:
code-review-excellence
+
multi-reviewer-patterns
+
security
+
e2e-testing
조합을 추천합니다.
2. 🥇 코드 동작 이해: explore
Melodic Software의 discovery:explore는 코드베이스를 먼저 탐색하고 dependency, git history, test, build configuration까지 조사하는 Skill입니다. GitHub
/plugin install discovery@...
또는 저장소에서 가져와:
git clone https://github.com/melodic-software/claude-code-plugins.git
프로젝트에 Skill을 복사할 수 있습니다.
discovery/explore SKILL.md
사용:
이 프로젝트를 먼저 탐색해줘.
인증 요청이 들어와서 DB에 저장되기까지의 전체 execution flow를 추적해줘.
관련 파일과 함수 호출 관계도 알려줘.
새로운 프로젝트를 이해할 때 정말 추천합니다.
3. 🥇 코드 시각화: codemap
이건 이번 조사에서 발견한 것 중 특히 추천하고 싶은 별도 Skill입니다.
beadnall/codemap은 단순 directory tree가 아니라 실제 codebase를 탐색 가능한 architecture diagram으로 만드는 Claude Skill입니다. README에 Claude Code용 ~/.claude/skills/codemap 설치 방법도 명시되어 있습니다. GitHub
git clone https://github.com/beadnall/codemap.git ~/.claude/skills/codemap
사용:
이 코드베이스를 codemap으로 시각화해줘.
또는:
이 프로젝트의 architecture와 주요 component 간 dependency를 시각화해줘.
추천 점수: ⭐⭐⭐⭐⭐
codemap GitHub
4. 🥇 코드 시각화: codeflow
akillness/jeo-skills의 codeflow도 상당히 흥미롭습니다.
GitHub repository / local folder / PR 등을 받아서:
- dependency graph
- blast radius
- code ownership
- health score
- PR impact
- security scan
- activity heatmap
등을 interactive architecture map으로 보여줍니다. GitHub
git clone https://github.com/akillness/jeo-skills.git
사용:
CodeFlow로 이 repository의 architecture를 분석해줘.
추천: ⭐⭐⭐⭐⭐
codeflow Skill GitHub
5. 🥇 코드 시각화: visual-explainer
jircik/Visual-Explainer는 코드베이스 전체 또는 Git diff를 interactive HTML dashboard로 만들어주는 Skill입니다. 특히 visual-explainer-diff가 있어서 PR/commit의 구조적 변화를 시각적으로 이해하는 데 좋습니다. GitHub
설치:
git clone https://github.com/jircik/Visual-Explainer.git
cp -r Visual-Explainer/skills/visual-explainer ~/.claude/skills/
cp -r Visual-Explainer/skills/visual-explainer-diff ~/.claude/skills/
사용:
이 코드베이스를 visual explainer로 설명해줘.
또는:
main과 현재 branch의 architecture 차이를 시각화해줘.
추천: ⭐⭐⭐⭐⭐
Visual-Explainer GitHub
6. 🥇 코드 → 다이어그램: drawio
drawio Skill은 코드 구조를:
- ERD
- UML
- Sequence diagram
- Architecture diagram
- Flowchart
- Network diagram
등으로 변환할 수 있습니다. 코드베이스 구조 시각화도 직접 trigger로 명시되어 있습니다. GitHub
git clone https://github.com/akillness/jeo-skills.git
사용:
이 코드베이스의 주요 class와 dependency를 draw.io architecture diagram으로 만들어줘.
추천: ⭐⭐⭐⭐⭐
drawio Skill GitHub
7. 🥇 PPT: pptx-deck-context
wshobson/agents에는 아예 PPTX Deck Creation plugin이 있고 다음 5개 Skill이 있습니다. GitHub
- pptx-deck-context
- pptx-slide-specification
- pptx-visual-assets
- pptx-reference-deck-analysis
- pptx-quality-gates
특히:
pptx-deck-context
→ 이야기 구조 / 자료 / 디자인 context
pptx-slide-specification
→ 실제 slide specification
pptx-visual-assets
→ 이미지 / SVG / diagram / infographic
pptx-reference-deck-analysis
→ 기존 PPT 디자인 분석
pptx-quality-gates
→ geometry / accessibility / editability 검증
순으로 연결할 수 있습니다.
gh skill install wshobson/agents pptx-deck-context
gh skill install wshobson/agents pptx-slide-specification
gh skill install wshobson/agents pptx-visual-assets
gh skill install wshobson/agents pptx-reference-deck-analysis
gh skill install wshobson/agents pptx-quality-gates
PPT를 자주 만든다면 이 5개는 세트로 추천합니다.
8. 🥇 실제 PPTX 생성: pptx-builder
Julien339/pptx-builder-skill은 HTML로 디자인한 slide를 실제 편집 가능한 PowerPoint 객체로 변환합니다. 단순히 PPT 화면을 이미지로 붙이는 방식이 아니라 text/shape/table/image/line 등을 native PPT object로 만듭니다. GitHub
설치:
git clone https://github.com/Julien339/pptx-builder-skill.git ~/.claude/skills/pptx-builder
사용:
pptx-builder를 사용해서
이 Markdown 내용을 편집 가능한 PowerPoint로 만들어줘.
추천: ⭐⭐⭐⭐⭐
pptx-builder GitHub
9. 🥇 한국어 PPT: pptx-cjk
한국어 PPT를 많이 만든다면 이쪽도 눈여겨볼 만합니다.
kbon526/claude-skill-pptx-cjk는 CJK/중국어·한국어·일본어 폰트, python-pptx, template cloning, chart, QA 등을 고려한 Skill입니다. README에 Claude Code 설치 명령도 명시되어 있습니다. GitHub
git clone https://github.com/kbon526/claude-skill-pptx-cjk.git ~/.claude/skills/pptx-cjk
특히:
한글 폰트
템플릿 복제
PPT 편집 가능 차트
PPT QA
가 필요한 경우 추천합니다.
추천: ⭐⭐⭐⭐⭐
pptx-cjk GitHub
10. 🥇 PPT 콘텐츠 자체를 잘 만들기: slide-skill
hunkim/slide-skill은 PPT를 만드는 것보다 **"슬라이드를 어떻게 구성해야 사람이 읽는가"**에 집중합니다.
핵심 원칙이:
One point per slide.
입니다.
즉 Claude가 한 장에 표 5개와 bullet 20개를 집어넣는 것을 막는 데 유용합니다. 영어뿐 아니라 한국어 trigger도 지원한다고 README에 명시되어 있습니다. GitHub
git clone https://github.com/hunkim/slide-skill.git ~/.claude/skills/slide-skill
사용:
slide-skill을 적용해서
이 내용을 발표용 PPT 구조로 다시 설계해줘.
추천: ⭐⭐⭐⭐⭐
slide-skill GitHub
제가 최종적으로 추천하는 "Claude Code 필수 20종"
100개를 모두 설치하는 대신 저는 아래처럼 구성하는 것을 권합니다.
🔥 Tier S — 거의 무조건
- feature-dev
- commit-commands
- code-review-excellence
- git-advanced-workflows
- debugging-strategies
- e2e-testing-patterns
- python-testing-patterns
- architecture-patterns
- api-design-principles
- frontend-design
🔥 Tier S — 코드 이해/시각화
- discovery:explore
- codemap
- codeflow
- visual-explainer
- drawio
🔥 Tier S — PPT / 보고서
- pptx-deck-context
- pptx-slide-specification
- pptx-quality-gates
- pptx-builder
- slide-skill
그리고 제일 추천하는 실제 Workflow
제가 Claude Code를 구성한다면 단순히 Skill을 많이 설치하지 않고 다음 Pipeline으로 만듭니다.
┌─────────────────┐
│ 사용자 요구사항 │
└────────┬────────┘
↓
feature-dev
↓
discovery/explore
↓
architecture
↓
구현
↓
┌─────────────┴─────────────┐
↓ ↓
code-review security-review
↓ ↓
└─────────────┬─────────────┘
↓
testing
↓
debugging / fix
↓
visual-explainer
↓
commit / PR
이렇게 구성하면 Claude Code가 단순히
"코드 작성 → 끝"
이 아니라
이해 → 설계 → 구현 → 리뷰 → 보안 → 테스트 → 시각화 → Git/PR
까지 하나의 개발 workflow로 움직이게 됩니다.
그리고 PPT까지 필요하면
코드/분석
↓
data-storytelling
↓
pptx-deck-context
↓
pptx-slide-specification
↓
pptx-visual-assets
↓
pptx-quality-gates
↓
pptx-builder
구조가 가장 좋습니다.
특히 이번에 요청하신 목적만 놓고 보면 code-review-excellence + discovery/explore + codemap/codeflow + feature-dev + pptx-* 조합을 가장 먼저 설치하는 것을 추천합니다. feature-dev 자체도 코드베이스 이해와 architecture 설계 후 구현하고, 마지막에 여러 관점의 code review를 수행하는 구조라 이 조합과 궁합이 좋습니다. GitHub+1
출처
네. 질문하신 게 **“PowerPoint처럼 보이는 발표자료를 만들되, 최종 산출물은 .pptx가 아니라 디자인이 좋은 단일 .html 파일”**이라면 일반적인 PPT Skill보다 HTML-first presentation Skill을 고르는 게 맞습니다.
제가 확인한 것 중에서는 아래 순서로 추천합니다.
🥇 1순위: frontend-slides
frontend-slides GitHub
가장 먼저 추천합니다.
이 Skill은 아예 Claude Code용 HTML presentation 전용 Skill이고, PowerPoint를 HTML로 변환하는 것뿐 아니라 처음부터 HTML 발표자료를 만들 수 있습니다. 현재 저장소에는 88개 layout preset + 34개 template가 있고, single-file HTML / zero dependency 방식입니다. GitHub
특징
- 16:9 발표 화면
- 단일 HTML
- inline CSS/JS
- 애니메이션
- 다양한 layout preset
- PPT/PPTX → HTML 변환
- visual style을 먼저 선택한 후 전체 deck 제작
- 브라우저에서 바로 실행
- 별도 빌드 과정 없음
설치
git clone https://github.com/dreamid27/frontend-slides.git \
~/.claude/skills/frontend-slides
또는 프로젝트 전용:
git clone https://github.com/dreamid27/frontend-slides.git \
.claude/skills/frontend-slides
이렇게 사용
frontend-slides를 사용해서
다음 내용을 16:9 발표자료 스타일의
단일 HTML 파일로 만들어줘.
주제: Claude Code 생산성 향상
청중: 개발자
분량: 12 slides
스타일: Apple keynote + dark mode
요구사항:
- 한 슬라이드 한 메시지
- 코드 예제 포함
- architecture diagram 포함
- 적절한 animation
- 브라우저에서 바로 열 수 있는 standalone HTML
추천도: ⭐⭐⭐⭐⭐
🥈 2순위: html-presentation
html-presentation GitHub
이건 제가 실무용으로 상당히 추천합니다.
단순히 예쁜 HTML을 만드는 것이 아니라:
기획 → 스토리라인 → 디자인 → HTML 생성 → 평가
까지 하나의 Skill로 묶어놨습니다. reveal.js 방식과 zero-dependency single-file HTML 두 가지 출력 경로도 지원합니다. GitHub
설치
git clone https://github.com/wbohanw/html-presentation.git \
~/.claude/skills/html-presentation
특히 좋은 점
SKILL.md뿐 아니라:
COMPOSITION.md
STYLE_PRESETS.md
SKILL.md
가 있어서 슬라이드 구성 원칙과 스타일 preset을 함께 활용할 수 있습니다. GitHub
사용 예
html-presentation을 사용해줘.
이 기술 문서를 개발자 대상 발표자료로 만들어줘.
- 16:9
- 15장
- dark professional style
- architecture diagram
- code comparison
- before/after
- 마지막에 summary
- 최종 결과는 standalone HTML
추천도: ⭐⭐⭐⭐⭐
🥉 3순위: cjl-slides
cjl-slides GitHub
“PPT 같은 HTML”을 원한다면 상당히 좋은 선택입니다.
무려 24개의 디자인 스타일을 제공하고:
- Pitch
- Linear
- Swiss
- Cyberpunk
- Y2K
- Chinese style
등의 스타일을 선택할 수 있습니다. HTML은 single-file이며 PPTX로 변환하는 기능도 있습니다. GitHub
설치
mkdir -p ~/.claude/skills/cjl-slides
git clone https://github.com/0xcjl/cjl-slides.git \
~/.claude/skills/cjl-slides
사용:
/cjl-slides
그리고 스타일을 선택합니다.
이런 경우 추천
회사 발표자료
IR
사업계획서
제품 소개
기술 세미나
컨퍼런스 발표
추천도: ⭐⭐⭐⭐⭐
4순위: slide-skill + HTML Skill 조합
slide-skill GitHub
이건 **디자인 Skill이라기보다 "좋은 발표자료를 만들게 하는 사고방식"**에 가깝습니다.
핵심 원칙이:
One point per slide
입니다. GitHub
즉 Claude가 이런 걸 만드는 것을 방지합니다.
┌──────────────────────────────┐
│ 시장 현황 │
│ │
│ • 데이터 1 │
│ • 데이터 2 │
│ • 데이터 3 │
│ • 표 │
│ • 그래프 │
│ • 설명 │
│ • 결론 │
└──────────────────────────────┘
대신:
┌──────────────────────────────┐
│ 시장은 빠르게 성장하고 있다 │
│ │
│ 📈 │
│ GRAPH │
│ │
│ 핵심 메시지 │
└──────────────────────────────┘
처럼 한 슬라이드 = 하나의 주장으로 만들도록 유도합니다.
설치
git clone https://github.com/hunkim/slide-skill.git \
~/.claude/skills/slide-skill
그리고 frontend-slides와 같이 사용합니다.
추천도: ⭐⭐⭐⭐⭐
5순위: claude-slides
Claude Slides GitHub
이건 1920×1080 고정 캔버스 기반 HTML deck을 만드는 Skill입니다. 키보드 navigation, progress bar, fullscreen, print-to-PDF, animation 등을 지원합니다. GitHub
설치
git clone https://github.com/marcogalluccio/claude-slides.git \
~/.claude/skills/claude-slides
특히:
1920 × 1080
↓
HTML
↓
브라우저 발표
↓
PDF 출력
workflow가 필요하면 좋습니다.
추천도: ⭐⭐⭐⭐☆
6순위: keynot
keynot GitHub
이건 이름부터 재미있습니다.
**“kill powerpoint with html”**을 목표로 하는 Claude Code Skill입니다. 단일 .html 파일을 만들고 keyboard navigation, swipe, fullscreen, animation 등을 제공합니다. 브랜드 가이드나 PDF 등을 받아 색상/타이포그래피를 CSS 변수로 추출하는 기능도 설명되어 있습니다. GitHub
추천하는 경우
우리 회사 홈페이지와 같은 느낌의
발표자료 만들어줘.
처럼 브랜드 일관성이 중요한 경우 좋습니다.
추천도: ⭐⭐⭐⭐☆
7순위: Olito slides
Olito-Labs/slides GitHub
이건 일반적인 "예쁜 PPT"보다 컨설팅 회사 스타일을 원할 때 좋습니다.
특징이:
Minto Pyramid
↓
Dot-dash storyline
↓
MECE 검증
↓
Assertion headline
↓
1920×1080 HTML
↓
PDF
구조입니다. GitHub
즉:
"예쁜 PPT"
보다는
"McKinsey/BCG 스타일의 논리적인 발표자료"
에 가깝습니다.
추천도: ⭐⭐⭐⭐⭐
8순위: md-slides
md-slides SKILL.md
Markdown → HTML slide deck을 만드는 Skill입니다.
특히:
- 6가지 layout
- speaker notes
- keyboard navigation
- light/dark theme
- handout printing
- content-density linter
가 들어 있습니다. GitHub
이런 workflow에 좋습니다
Markdown
↓
Claude
↓
md-slides
↓
HTML
추천도: ⭐⭐⭐⭐☆
제가 가장 추천하는 조합
질문하신 목적이
"PPT처럼 디자인된 발표자료를 HTML로 만들고 싶다."
라면 저는 아래처럼 구성하겠습니다.
Claude Code
│
▼
┌──────────────┐
│ slide-skill │
│ 발표 논리/구성 │
└──────┬───────┘
│
▼
┌──────────────────┐
│ frontend-slides │
│ HTML 디자인/레이아웃 │
└────────┬─────────┘
│
▼
standalone HTML
│
┌────────────┼────────────┐
▼ ▼ ▼
Browser PDF PPTX
설치
# 1. 발표 논리
git clone https://github.com/hunkim/slide-skill.git \
~/.claude/skills/slide-skill
# 2. HTML presentation
git clone https://github.com/dreamid27/frontend-slides.git \
~/.claude/skills/frontend-slides
# 3. 필요하면 컨설팅 스타일
git clone https://github.com/Olito-Labs/slides.git \
~/.claude/skills/olito-slides
⭐ 목적별로 고르면
목적추천 Skill점수
| PPT 같은 HTML | frontend-slides | ⭐⭐⭐⭐⭐ |
| 가장 다양한 디자인 | cjl-slides | ⭐⭐⭐⭐⭐ |
| 논리적인 회사 발표 | Olito slides | ⭐⭐⭐⭐⭐ |
| McKinsey 스타일 | slides-builder | ⭐⭐⭐⭐⭐ |
| 예쁜 + 애니메이션 | frontend-slides | ⭐⭐⭐⭐⭐ |
| 브랜드 스타일 적용 | keynot | ⭐⭐⭐⭐ |
| 코드 발표자료 | frontend-slides | ⭐⭐⭐⭐⭐ |
| 기술 아키텍처 발표 | html-presentation | ⭐⭐⭐⭐⭐ |
| Markdown → HTML | md-slides | ⭐⭐⭐⭐ |
| HTML → PPTX도 필요 | pptx-builder | ⭐⭐⭐⭐⭐ |
slides-builder 역시 실제로 McKinsey-style / one insight per slide / single-file HTML을 목표로 하는 Skill입니다. GitHub
특히 제가 추천하는 최종 구성
개발자용 기술 발표자료를 많이 만들 거라면:
① slide-skill
└─ 발표 논리 / 한 슬라이드 한 메시지
② frontend-slides
└─ 실제 HTML 디자인
③ codemap / codeflow
└─ 코드 구조 시각화
④ drawio
└─ Architecture / ERD / Sequence diagram
⑤ pptx-builder
└─ 필요할 때 PPTX로 변환
이렇게 하면 상당히 강력합니다.
예를 들어 Claude Code에서 최종적으로:
다음 GitHub 프로젝트를 분석해서
개발자 대상 15분 발표자료를 만들어줘.
1. 코드베이스 구조를 분석하고
2. 핵심 execution flow를 찾아내고
3. architecture diagram을 만들고
4. 중요한 코드는 syntax highlighting으로 보여주고
5. Before/After를 비교하고
6. 한 슬라이드에 하나의 메시지만 넣고
7. PPT 스타일의 16:9 디자인으로 만들고
8. animation을 적절히 넣고
9. 최종 결과는 단일 standalone HTML로 만들어줘.
slide-skill + frontend-slides + codemap을 활용해.
라고 시키는 방식이 현재 목적에는 가장 적합합니다.
그리고 "PPT 스타일"을 단순히 PPT처럼 생긴 HTML이 아니라, 실제 PowerPoint의 디자인 수준으로 만들고 싶다면 frontend-slides와 cjl-slides를 먼저 비교해보는 것을 권합니다. 특히 cjl-slides는 24개 스타일을 명시적으로 제공하기 때문에 스타일 선택이 중요한 경우 유리합니다. GitHub
출처