https://skillmaru.hell0world.net/manual

SkillMaru는 AI 에이전트용 스킬을 찾고, 설치하고, 직접 발행하는 스킬 레지스트리입니다. 이 매뉴얼은 화면을 따라가며 핵심 기능을 한 번에 익히도록 돕고, 무료 회원가입으로 무엇이 더 열리는지 안내합니다.

01. 홈에서 스킬 둘러보기

홈 화면은 SkillMaru의 출발점입니다. 상단의 커맨드라인 스타일 검색창에 스킬 이름이나 “하는 일”을 입력하면 곧바로 찾을 수 있고, 아래로는 인기 스킬과 최신 릴리스가 카드로 정리돼 있습니다.

각 카드에는 스킬 이름, 카테고리, 버전, 다운로드 수, 제작자가 함께 표시돼 한눈에 신뢰도를 가늠할 수 있습니다.

• “New here?” 안내를 열면 CLI 설치부터 첫 스킬까지 3단계로 따라 할 수 있습니다.

• 우측 상단에서 라이트/다크 테마와 표시 언어(한국어·English)를 바꿀 수 있습니다.

홈: 검색창 + 인기 스킬(다운로드순) + 최신 릴리스(발행순)

02. 검색으로 원하는 스킬 찾기

검색 페이지에서는 키워드로 스킬을 찾고, 카테고리·제작자·정렬·출처 같은 조건으로 결과를 좁힐 수 있습니다.

이름이 정확히 기억나지 않아도 “무엇을 하는 스킬인지”를 설명하는 단어로 찾을 수 있도록 설명 기반으로 검색됩니다.

검색: 키워드 + 카테고리·제작자·정렬 필터

03. 카테고리로 탐색하기

무엇을 찾을지 아직 정하지 않았다면 카테고리부터 둘러보세요. 생산성, 코딩, 디자인, 라이프스타일 등 용도별로 스킬이 묶여 있어 관심 분야를 빠르게 훑어볼 수 있습니다.

카테고리: 용도별로 묶인 스킬 모음

04. 스킬 상세 확인하기

스킬 카드를 누르면 상세 페이지가 열립니다. 여기서 README 문서, 버전 이력, 설치 방법, 제작자와 출처 저장소를 확인할 수 있습니다.

설치 전에 이 스킬이 실제로 무엇을 하는지, 어떤 버전이 최신인지 충분히 살펴본 뒤 내려받으세요.

스킬 상세: README · 버전 이력 · 설치 방법 · 출처

05. CLI 로 설치해 사용하기

SkillMaru CLIskillmaru)를 쓰면 터미널에서 곧바로 스킬을 검색·설치하고, Claude Code·Cursor·Codex 같은 에이전트 폴더에 맞춰 넣을 수 있습니다. 레지스트리 주소는 기본값이 skillmaru.hell0world.net 라 따로 지정하지 않아도 됩니다.

설치 & 로그인

# CLI 설치 (npm)
npm install -g @cookyman/skillmaru

# 회원가입 후 웹에서 발급한 API 토큰으로 로그인
skillmaru login --token sk_xxx
skillmaru whoami          # 로그인 확인




검색 & 설치

# 스킬 검색
skillmaru search “weather”

# 에이전트 폴더에 설치 (namespace/slug)
skillmaru install global/weather --agent claude-code

# 버전 고정 · 프로젝트 범위로 설치
skillmaru install global/weather --version 1.2.0 --scope project

관리 & 발행

# 로컬 설치 목록 / 제거
skillmaru list
skillmaru remove global/weather

# 로컬 스킬 패키지 발행 (먼저 --dry-run 으로 검증)
skillmaru publish ./my-skill --dry-run
skillmaru publish ./my-skill --visibility public

• CLI 인증에는 회원가입 후 웹에서 발급한 API 토큰이 필요합니다. SKILLHUB_TOKEN 환경변수로도 인증돼 CI 에 연결할 수 있습니다.

• 모든 명령에 --json 을 붙이면 기계가 읽는 형식으로 출력돼 스크립트·자동화에 쓸 수 있습니다.

• 설치 내역은 각 기기의 로컬에 기록됩니다(기기 간 자동 동기화 아님). 다른 기기에서는 다시 install 하세요. 기기 간에 유지되는 것은 웹에서 누른 즐겨찾기입니다.

왜 회원가입인가

회원가입하면 이런 게 열립니다

둘러보기는 로그인 없이도 가능하지만, 무료 회원가입 한 번이면 SkillMaru를 “쓰는 곳”에서 “만들고 관리하는 곳”으로 바꿀 수 있습니다.

이메일과 비밀번호만 있으면 1분 안에 시작할 수 있습니다.