AI 스킬 디렉터리 Cola Skill, 무엇을 확인하고 써야 하나

에이전트에 붙여 쓸 스킬을 찾다 보면 이런 목록 사이트를 여러 곳 만나게 됩니다. Cola Skill도 그중 하나로, 분야별로 스킬을 모아 보여 주는 디렉터리입니다. 이 글은 사이트와 관련 공개 저장소를 직접 열어 보고 확인된 사실만 정리한 기록입니다. 스킬을 내 작업 환경에 넣기 전에 무엇을 봐야 하는지도 함께 적었습니다.

AI 스킬은 마크다운 한 장에서 시작합니다

요즘 말하는 AI 스킬은 에이전트가 필요할 때 꺼내 읽는 지침 묶음입니다. 형식은 단순합니다. 폴더 하나를 만들고 그 안에 SKILL.md를 두면 끝입니다. 파일 맨 위 YAML 머리말에 name과 description을 적고, 그 아래 본문에 절차를 서술합니다. Claude Code 문서 기준으로 공개 표준이 정의하는 머리말 항목은 name, description, license, compatibility, metadata, allowed-tools입니다. 필수는 앞의 둘뿐입니다.

동작 방식이 이 형식의 핵심입니다. 평소 문맥에 올라가 있는 것은 설명문 한 줄이고, 본문은 그 설명이 지금 하려는 일과 맞을 때 읽힙니다. 폴더 안에 넣어 둔 참고 문서나 스크립트는 본문이 그것을 가리킬 때 열립니다. 수십 개를 깔아 두어도 평소 비용이 크지 않은 이유입니다.

저장 위치도 정해져 있습니다.

• 개인용: ~/.claude/skills/<이름>/SKILL.md
• 프로젝트용: 저장소 안의 .claude/skills/<이름>/SKILL.md
• 플러그인 배포: 플러그인 폴더의 skills/ 하위

배포 단위가 폴더 하나라 압축 파일로 주고받아도 되고, 저장소를 통째로 받아도 됩니다. 스킬 목록 사이트가 여기저기 생기는 배경이 이 단순함입니다.

Cola Skill 사이트에서 확인되는 것

먼저 걸린 문제부터 적습니다. 이 사이트는 자바스크립트로 화면을 그립니다. 서버 응답만 받아 오면 "Cola Skill"이라는 제목 말고는 아무것도 잡히지 않습니다. robots.txt와 sitemap.xml 경로를 따로 요청해 봐도 같은 껍데기 문서가 돌아왔습니다. 그래서 내용 확인은 검색 색인에 남은 것에 기댔습니다.

색인에 잡히는 분류는 Creative & Design, Growth & Marketing, Product & Tech, Solo Business, Workplace & Office, Self-improvement, Teaching, Research & Analysis, E-commerce Operations입니다. 개발용 스킬만 모아 둔 곳은 아닙니다. 마케팅과 전자상거래, 사무 업무, 교육 쪽 분류가 나란히 있습니다.

주소 구조는 슬러그 하나에 스킬 하나입니다. colaskill.com/claude-seo/ 같은 개별 스킬 페이지가 있고, colaskill.com/lijigang-ljg-skills/처럼 만든 사람 이름을 딴 묶음 페이지도 색인되어 있습니다. 사이트가 스스로 밝히는 성격은 Cola 스킬을 찾아보고 Cola로 가져가는 곳입니다. 1차 대상은 ColaOS 사용자로 보입니다.

다만 SKILL.md 형식을 따르는 스킬이라면 다른 에이전트에서도 그대로 읽힙니다. 그래서 특정 도구를 쓰지 않더라도 목록을 훑어보는 값은 있습니다. 남들이 어떤 작업을 스킬로 접어 넣었는지 보는 카탈로그로 쓰는 쪽입니다. 등록된 스킬 수와 가격, 스킬 등록 절차는 이번에 확인하지 못했습니다. 그 부분은 브라우저로 직접 열어 봐야 합니다.

배포 방식은 공개 저장소에서 드러납니다

같은 이름을 쓰는 marswaveai/skills 저장소는 그냥 열립니다. 저장소 설명은 "Skills from ListenHub.ai & ColaOS", 라이선스는 MIT입니다. 설치는 npx skills add marswaveai/skills 한 줄이고, 갱신은 npx skills update -g입니다. README가 밝히는 지원 도구는 Claude Code, Cursor, Windsurf, OpenCode, Codex, Trae입니다.

최상위 폴더를 성격별로 묶으면 이렇습니다.

• 음성: tts, asr, voice-clone, listenhub-voice
• 영상과 슬라이드: video-gen, explainer, slides
• 그 밖의 제작: music, podcast, image-gen, graphify-out, cola-avatar-pack
• 문서와 글: content-parser, creator
• 공통 규칙: shared

tts/SKILL.md를 열어 보면 머리말에 이름과 설명이 있고, 설명 안에 "TTS", "text to speech" 같은 호출 문구가 박혀 있습니다. 본문은 인증 확인, 모드 판별, CLI 호출 순서로 이어집니다. 여러 스킬이 shared를 심볼릭 링크로 걸어 공통 규칙을 참조합니다. creator처럼 templates/와 별도 엔진 폴더를 함께 두는 스킬도 있고, cola-avatar-pack은 SKILL.md 옆에 40KB짜리 생성 지침 문서와 scripts/를 둡니다.

여기서 한 가지가 분명해집니다. 이 저장소의 스킬 상당수는 마크다운만으로 완결되지 않습니다. ListenHub CLI를 전역 설치하고 listenhub auth login으로 로그인해야 하며, 일부 기능은 API 키를 요구합니다. 스킬은 지침이고 실제 작업은 외부 서비스가 합니다. 계정과 과금 조건은 그쪽 정책을 따로 봐야 합니다.

만든 쪽과 확인되지 않은 부분

GitHub 조직 marswave.ai 프로필에는 위치가 China, 연락처가 support@marswave.ai, 소셜 계정이 X의 @ColaOSofficial로 적혀 있습니다. 공개 저장소로는 에이전트용 마크다운 에디터 ColaMD, 에이전트 공통 기능을 담은 coli, ColaOS 플러그인 모음 cola-plugins, macOS 음성 입력 도구 TypeNo, 그리고 ListenHub SDK와 CLI가 올라와 있습니다. ListenHub와 ColaOS가 같은 팀 산출물이라는 점은 저장소 이름과 설명에서 그대로 확인됩니다.

ColaOS 쪽 사이트인 colaos.ai도 자바스크립트로 그려집니다. 서버 응답에서 확인되는 것은 문서 제목 "ColaOS | Cola - Your AI Sidekick"까지입니다. 제품 설명을 다룬 글이 검색에는 여럿 걸리지만 상당수가 공식 문서가 아닌 3자 페이지라, 여기서는 제목 이상을 단정하지 않겠습니다.

하나 더 짚어 둡니다. colaskill.com의 운영 주체가 MarsWave인지는 사이트에서 직접 확인하지 못했습니다. 이름이 겹치고 사이트가 Cola를 전제로 설명한다는 점에서 관련은 있어 보이지만, 공식 페이지에서 밝혀지기 전까지는 같은 곳이라고 적지 않는 편이 정확합니다. 소개 글에서 흔히 뭉개는 부분이라 일부러 남깁니다.

스킬을 받기 전에 열어 볼 것

스킬은 에이전트에게 건네는 지침입니다. 홈 디렉터리에 폴더를 하나 푸는 순간 그 지침이 내 작업에 개입할 수 있습니다. 목록에서 눈에 띈다고 바로 설치하지 말고 아래를 먼저 봅니다.

• SKILL.md 본문 전체, 특히 설명문의 호출 조건
• scripts/ 안에 든 실제 실행 코드
• allowed-tools 항목 유무와 그 범위
• 외부 CLI, 계정, API 키 요구 여부
• 라이선스와 원본 저장소 주소
• 갱신 경로가 사이트인지 저장소인지

관리는 파일 단위로 합니다. 폴더 이름 앞에 밑줄을 붙이면 잠시 꺼 둘 수 있고, 폴더를 지우면 제거됩니다.blogspot.com/2025/03/20.html)를 먼저 훑어도 됩니다.

열어 보면 별것 아닌 스킬도 많습니다. 그런데 그게 이런 목록 사이트의 진짜 쓸모이기도 합니다. 남이 쓴 SKILL.md를 몇 개 읽고 나면 내가 매번 채팅창에 붙여 넣던 절차를 어떻게 파일 한 장으로 접어 둘지 감이 잡힙니다. 정작 필요한 일은 남의 스킬을 잔뜩 설치하는 쪽보다 내 절차를 SKILL.md로 옮겨 적는 쪽인 경우가 많습니다. 이를테면 쿠버네티스 인증서 만료를 확인하고 갱신하는 절차 처럼 매번 같은 순서로 밟는 일이 후보입니다.

설치 전에 확인할 것

분류를 훑어보는 목적이면 Cola Skill 사이트를, 실제로 설치해 쓸 생각이면 marswaveai/skills 저장소를 보는 게 낫습니다. 사이트는 본문이 자바스크립트로 그려져 검색으로는 아예 걸리지 않습니다.

스킬 수와 가격, 운영 주체는 확인하지 못했으니 유료 여부가 걸린다면 Cola Skill 사이트의 안내를 먼저 보세요. 저장소 스킬 상당수는 ListenHub CLI 로그인과 API 키를 전제로 합니다.

쓰려는 스킬의 SKILL.md와 스크립트를 먼저 열어, 어떤 로그인과 키를 요구하는지 확인한 뒤 설치하세요.