Communitygithub.com

nattergabriel/reseed

프로젝트 전반에 걸쳐 에이전트 스킬을 관리하고 배포하기 위한 CLI 도구

reseed란 무엇인가요?

reseed는 개인 스킬 라이브러리를 관리하고 프로젝트에 스킬을 설치하는 CLI 도구입니다. 스킬은 SKILL.md 파일을 포함하는 디렉토리로, Agent Skills 사양을 따릅니다. 이 도구는 Claude Code, Cursor, Copilot, Codex, Gemini CLI 등 30개 이상의 에이전트에서 읽을 수 있는 각 프로젝트의 스킬 디렉토리(기본적으로 `.agents/skills/`, Claude Code의 경우 `.claude/skills/`)에 스킬을 저장합니다. 주요 역할은 프로젝트 측면에서 설치된 스킬을 확인하고, 필요한 스킬을 추가하며, 동기화 상태를 유지하는 것입니다. 또한 사용자가 GitHub에서 스킬을 라이브러리로 가져오려면 `reseed install`을 실행할 수 있지만, 라이브러리의 구조와 내용은 사용자가 관리하도록 남겨둡니다. `reseed` 명령어(인자 없음)는 대화형 TUI를 열며, 이는 사용자가 직접 터미널에서 실행하도록 설계되었습니다. AI 에이전트는 `reseed status`, `reseed list`, `reseed add`, `reseed remove`, `reseed sync`와 같은 CLI 명령어를 사용하여 프로젝트 스킬을 관리해야 합니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add nattergabriel/reseed

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

reseed: 에이전트 스킬 매니저

reseed는 개인 스킬 라이브러리를 관리하고 프로젝트에 스킬을 설치합니다. 스킬은 SKILL.md 파일을 포함하는 디렉토리로, Agent Skills 사양을 따릅니다. 스킬은 각 프로젝트의 스킬 디렉토리(기본적으로 .agents/skills/, Claude Code의 경우 .claude/skills/)에 위치하며, 30개 이상의 에이전트(Claude Code, Cursor, Copilot, Codex, Gemini CLI 등)에서 읽을 수 있습니다.

당신의 주요 역할은 프로젝트 측면입니다: 설치된 스킬을 확인하고, 필요한 스킬을 추가하며, 동기화 상태를 유지하는 것입니다. 사용자가 GitHub에서 스킬을 라이브러리로 가져오려 할 때 reseed install을 실행할 수도 있지만, 라이브러리의 구조와 내용은 사용자에게 맡기는 것이 좋습니다.

참고: reseed (인자 없음)는 대화형 TUI를 엽니다. 이는 사용자가 자신의 터미널에서 실행하도록 설계된 것이므로, 당신이 실행해서는 안 됩니다. 사용자가 라이브러리를 시각적으로 탐색하려면 직접 reseed를 실행하라고 안내하세요. 그 외의 경우에는 아래 CLI 명령어를 사용하세요.

빠른 참조

reseed                              # 대화형 TUI (사용자가 실행, 당신은 실행 금지)
reseed init <path>                  # 새 라이브러리 생성 (최초 설정)
reseed status                       # 현재 프로젝트에 설치된 스킬 확인
reseed list -l                      # 사용자 라이브러리의 스킬 목록 (설명 포함)
reseed add <skills-or-packs...>     # 라이브러리에서 프로젝트로 스킬/팩 복사
reseed add --all                    # 라이브러리의 모든 스킬 추가
reseed remove <skills...>           # 프로젝트에서 스킬 제거
reseed sync                         # 라이브러리에서 설치된 스킬 다시 복사 (업데이트)
reseed install <user/repo>          # GitHub에서 라이브러리로 스킬 가져오기

작동 방식

  • 사용자는 라이브러리를 가지고 있습니다: 모든 스킬이 포함된 시스템의 디렉토리입니다. 여기에는 팩(관련 스킬의 명명된 그룹)도 포함될 수 있습니다.
  • reseed add는 라이브러리에서 프로젝트의 스킬 디렉토리로 스킬을 복사합니다. 이는 실제 파일 복사본이며 심볼릭 링크가 아니므로 git에 표시되고 모든 팀 구성원이 사용할 수 있습니다.
  • reseed sync는 프로젝트와 라이브러리 모두에 존재하는 스킬을 다시 복사하여 업데이트를 가져옵니다. 라이브러리에 없는 스킬은 그대로 두며, 고아 스킬(라이브러리에서 제거된 후 프로젝트에 추가된 스킬)도 포함됩니다. sync는 오래된 복사본을 삭제하지 않습니다. 이 경우 reseed remove를 사용하세요.
  • 프로젝트 매니페스트는 없습니다. 동기화는 폴더 이름을 기준으로 일치시킵니다.

일반적인 워크플로우

0. 대상 디렉토리 확인

프로젝트 측 명령어를 실행하기 전에 reseed가 대상으로 하는 디렉토리를 확인하세요:

reseed config dir

이 명령어가 .agents/skills (default)를 출력하지만 사용자가 Claude Code(.claude/skills/를 읽음)를 사용 중인 경우, reseed config dir .claude/skills를 한 번 실행하여 전역 기본값을 변경하도록 제안하세요. 이는 사용자 전체 설정을 변경하므로 실행 전에 확인을 받으세요. 사용자가 기본값 변경을 원하지 않으면 각 명령어에 --dir .claude/skills를 대신 전달하세요:

reseed --dir .claude/skills add commit

reseed config dir이 이미 올바른 경로를 출력한다면 재정의할 필요가 없습니다. 아래 명령어를 그대로 실행하세요.

1. 현재 상태 확인

reseed status

스킬 디렉토리가 아직 없어도 괜찮습니다. reseed는 스킬을 추가할 때 자동으로 생성합니다.

2. 사용 가능한 스킬 확인

reseed list -l

이 명령어는 사용자 라이브러리의 모든 스킬과 팩을 설명과 함께 표시합니다. 추가할 스킬을 제안하기 전에 이 목록을 통해 어떤 스킬이 있는지 파악하세요.

3. 프로젝트에 스킬 추가

reseed add commit review python-base   # 하나의 명령어에 스킬과 팩 혼합
reseed add --all                       # 또는 모든 것을 추가

하나의 reseed add 명령어에 여러 스킬과 팩을 전달할 수 있으며, reseed는 자동으로 팩을 개별 스킬로 확장합니다. 프로젝트의 스택과 요구 사항에 맞는 스킬을 선택하세요.

4. 스킬 최신 상태 유지

reseed sync

사용자가 최신 버전의 스킬을 프로젝트로 가져오려 할 때 이 명령어를 실행하세요.

GitHub에서 스킬 설치하기

install과 add는 다른 작업을 수행합니다:

  • reseed install은 GitHub에서 사용자의 라이브러리로 가져옵니다. URL이 아닌 user/repo[/path][@version] 참조를 사용합니다.
  • reseed add는 라이브러리에서 프로젝트로 복사합니다. 로컬 스킬 또는 팩 이름을 사용합니다.
reseed install user/repo                 # 리포지토리의 모든 스킬
reseed install user/repo/path/to/skills  # 특정 디렉토리 아래의 스킬
reseed install user/[email protected]            # 버전 태그로 고정
reseed install user/repo --pack mypack   # 팩으로 그룹화

설치 후 reseed add를 사용하여 프로젝트로 가져오세요.

GitHub의 공개 API는 시간당 약 60개의 인증되지 않은 요청만 허용하므로, 여러 번의 설치를 연속으로 실행하면 속도 제한에 걸릴 수 있습니다. reseed install이 속도 제한 오류로 실패하면 환경에 GITHUB_TOKEN을 설정하여 인증하도록 제안하세요.

reseed가 설치되지 않은 경우

reseed 명령어를 찾을 수 없으면 사용자에게 설치 명령어를 안내하세요:

curl -fsSL https://raw.githubusercontent.com/nattergabriel/reseed/main/install.sh | sh

Windows에서는 최신 릴리스에서 바이너리를 다운로드할 수 있습니다.

라이브러리가 아직 없는 경우

reseed가 설치되었지만 명령어가 "라이브러리가 초기화되지 않음" 오류와 함께 실패하면 사용자가 한 번 라이브러리를 생성해야 합니다:

reseed init ~/skills    # 또는 원하는 경로

그 후 CLI 명령어가 새 라이브러리에서 작동하기 시작합니다.

관련 스킬