Agent Skills 입문 | 일본어로 검색할 수 있는 cccskills
機械翻訳 / Machine-translated
A
AI Friends
2日前・9分で読める
機械翻訳 / Machine-translated
@aifriends
AI Friends（https://aifriends.jp）のクロスポスト公式アカウント。AIツールの紹介・使い方・できることを、中学生でもわかるやさしい日本語で届けます。
「Claude Code에 스킬을 추가할 수 있다고 들었는데, 어디서 찾으면 될까?」라고 생각해본 적 있으신가요? 영어로 된 GitHub를 끝없이 뒤지는 건 쉽지 않습니다. 이 글에서는 일본어로 검색할 수 있는 「cccskills」 사용법과 인기 스킬을 시험해보는 방법을 소개합니다.
Agent Skills(에이전트 스킬)는 AI에게 특정 작업 방법을 알려주기 위한 시스템입니다. 내용물은 SKILL.md라는 파일이 들어 있는 폴더 하나뿐입니다.
Claude Code의 공식 문서에 따르면, 파일 맨 위에 이름과 설명(YAML 프런트매터라는 설정 항목)을 작성하고, 그 아래에 Markdown으로 절차를 작성합니다. 저장 위치는 내 컴퓨터 전체에서 사용하려면 ~/.claude/skills/, 특정 프로젝트에서만 사용하려면 .claude/skills/입니다.
흥미로운 점은 불러오는 방식입니다. 평소에는 각 스킬의 「설명」만 Claude의 메모리에 로드되어 있고, 본문은 필요할 때 비로소 읽어들입니다. 즉, 스킬을 많이 추가해도 동작이 무거워지기 어려운 구조입니다.
호출 방법은 2가지입니다. /스킬명을 입력해 직접 호출하는 방법과, 요청 내용이 설명과 맞아떨어질 때 Claude가 자동으로 사용하는 방법입니다.
이 형식은 원래 Anthropic이 만들었으며, 현재는 Agent Skills 공식 사이트에서 공개된 오픈 규격입니다. 동일한 스킬을 Cursor, Gemini CLI, GitHub Copilot 등 지원하는 다른 도구에서도 사용할 수 있습니다.
스킬은 사용법만 알면 편리합니다. 그런데 수가 너무 많아 찾기 어렵다는 문제가 있었습니다. 그래서 등장한 것이 cccskills입니다.
캐치카피는 「하고 싶은 것을, 일본어로 검색.」입니다. GitHub에 공개된 스킬을 모아 일본어 소개 문구를 붙여 놓았습니다.
2026년 10월 기준 메인 페이지에는 등록 스킬 약 9.1만 건이라고 표시되어 있습니다. 그 중 일본어 소개가 붙어 있는 것은 2,845건입니다. 전체에서 보면 아직 일부에 불과하지만, 평가가 높은 스킬에는 일본어 소개가 붙어 있습니다.
검색 방법은 검색창에 「회의록」「소설」「SEO」 같은 단어를 입력하는 것뿐입니다. 인기 검색어로는 코드 리뷰, PowerPoint, Excel, 디자인, 테스트 등이 있습니다.
카테고리는 「개발」「집필·창작」「비즈니스」「데이터·AI」등 14가지 분류입니다. 관심 있는 스킬 페이지에는 일본어 개요와 「활용 상황」이 나와 있습니다.
cccskills의 스킬 페이지에는 추가를 위한 명령어가 표시되어 있습니다. 복사해서 터미널에 붙여넣기만 하면 됩니다. 예를 들어 다음과 같은 형태입니다.
npx skills add https://github.com/coji/natural-japanese --skill natural-japanese
이 명령어를 사용하려면 Node.js가 설치되어 있어야 합니다.
명령어가 어려운 분은 Claude에게 「이 스킬을 추가해줘」라고 요청하는 방법도 있습니다. 스킬의 GitHub 경로를 알려주고, 내용을 확인한 뒤 ~/.claude/skills/natural-japanese/에 넣어달라고 요청하면 됩니다.
여기서 중요한 주의 사항이 있습니다. 스킬은 「AI에 대한 지시서」이므로, 악의적인 지시가 섞여 있을 가능성도 있습니다. cccskills 페이지에도 스킬의 품질이나 안전성을 보장하지 않는다고 명시되어 있습니다.
공개된 스킬의 라이선스는 각 리포지토리를 따릅니다. 추가하기 전에 원본 GitHub에서 SKILL.md와 동봉된 스크립트를 직접 확인하세요.
여기서는 구체적인 예시를 소개합니다. cccskills에서 「집필·창작」 카테고리에 있는 natural-japanese 페이지를 살펴보겠습니다.
작성자는 coji 씨로, GitHub 리포지토리는 이 글 작성 시점 기준으로 스타 약 1,900개(페이지상에는 1,899개), 포크 53건, 라이선스는 MIT입니다.
업무용 일본어를 읽기 쉽게 쓰거나 다듬기 위한 스킬입니다. 회의록, 조사 보고서, 사내 매뉴얼, 기획서, 이메일, 슬라이드 구성안 등이 대상입니다. AI가 작성한 문장에서 느껴지는 「AI 냄새」를 줄이는 것도 목표로 하고 있습니다.
예를 들어, 회의 담당이 된 신입사원을 상상해보세요. 녹음을 텍스트로 변환하고 AI에게 회의록을 정리해달라고 했더니, 어딘가 어색해서 상사에게 제출하기가 꺼려지는 문장이 나왔습니다.
그럴 때 「읽기 쉽게 해줘」라고 요청하면 스킬이 호출됩니다. 리포지토리 설명에 따르면, 「읽기 쉽게 해줘」「결론부터 써줘」「어색한 표현을 고쳐줘」 같은 요청 시 자동으로 사용된다고 합니다.
모드는 2가지입니다. 일상적인 문서용 「퀵」과, 중요한 문서나 장문용 「풀」입니다. 풀 모드는 시간이 걸리기 때문에, 시작 전에 소요 시간 목표를 알려줍니다.
내용을 수정하지 않고 채점만 하는 score라는 사용 방법도 있습니다. 직접 작성한 문장의 자연스러움을 0~100점으로 진단받을 수 있습니다.
공정은 설계, 집필, 자동 검사, 수정의 반복 순서입니다. 검사에는 lint.py라는 스크립트를 사용하여 틀에 박힌 표현이나 번역투를 걸러냅니다. 수정할지 남길지는 AI가 문맥을 보고 판단합니다.
마지막에는 6가지 관점에서 채점합니다. 합격 기준은 각 관점에서 90점 이상, 평균 92점 이상입니다. 동봉 파일은 총 26개입니다.
실행에는 uv라는 Python용 도구가 필요합니다. 또한 의미적 검출을 수행하는 semantic.py는 실험적 기능으로, 첫 실행 시 약 1GB의 모델을 다운로드합니다. 가볍게 시험해보고 싶은 분은 이 기능을 사용하지 않아도 괜찮습니다.
스킬을 구하는 방법은 cccskills만 있는 것이 아닙니다. 차이점을 정리해봅니다.
먼저 cccskills에서 인기 있는 스킬을 추가해보고, 익숙해지면 직접 만들어보는 순서가 무리 없이 진행할 수 있습니다.
일본어 문서를 다루는 업무는 회의록, 보고서, 이메일 등 무수히 많습니다. 해외에서 만들어진 스킬은 영어 문서를 위한 것이 많기 때문에, 일본어에 맞춘 절차가 담긴 스킬은 귀중합니다. natural-japanese처럼 일본어 표현을 검사하는 스크립트까지 포함된 것은 그 대표적인 예입니다.
cccskills에는 이메일 주소만으로 무료 가입할 수 있으며, zip 파일을 업로드하여 공개할 수 있는 크리에이터용 기능도 있습니다. 여러 스킬을 묶은 「스킬셋」과 유료 판매도 지원합니다.
일본 현장에서 갈고닦은 노하우를 스킬로 만들어 공유하는 장소로도 활용할 수 있다는 의미입니다. 단, 스킬셋은 현재 페이지상에서 0건으로 표시되어 있었습니다. 앞으로 성장해나갈 단계인 것 같습니다.
A. natural-japanese는 MIT 라이선스로 공개되어 있습니다. cccskills 자체도 공개된 GitHub 스킬은 각 리포지토리의 라이선스를 따른다고 안내하고 있습니다. 한편, 크리에이터가 유료로 판매하는 스킬도 있으므로 페이지 표시를 확인하세요.
A. Agent Skills는 오픈 규격으로, Cursor, Gemini CLI, GitHub Copilot 등 많은 도구가 지원하고 있습니다. 다만, 스킬에 따라서는 특정 도구를 전제로 작성된 경우도 있습니다.
A. 네, 사용할 수 있습니다. 추가할 때는 「이 스킬을 추가해줘」라고 Claude에게 요청하면 되고, 추가한 후에는 일반적인 언어로 요청하기만 하면 됩니다. 단, natural-japanese처럼 실행하기 위해 uv 같은 도구가 필요한 스킬도 있습니다.
A. 추가하기 전에 SKILL.md와 동봉된 스크립트를 읽는 것입니다. 이해할 수 없는 외부 통신이나 파일 삭제 명령이 없는지 확인하세요. cccskills는 품질이나 안전성을 보장하지 않습니다.
다음 단계로, cccskills에서 「회의록」을 검색하여 관심 있는 스킬의 페이지를 열어보세요.
이 글은 AI Friends에서 교차 게시된 글입니다.
