월 US$9.99에 모든 Premium Skill을 이용하세요. 언제든지 취소할 수 있습니다.플랜 보기

Agent Skills 업데이트, 롤백, 삭제

Skill도 다른 의존성과 마찬가지입니다. 출처를 기록해 두고, 의도할 때 업데이트하고, 백업이 어디에 저장되는지는 필요해지기 전에 알아 두세요.

대상
Skill을 관리하는 사람
지원
Claude Code, Codex, Cursor
소요 시간
8분

짧은 답변

Skillry Skill을 업데이트하려면 --force를 붙여 설치 명령어를 다시 실행하세요. CLI가 기존 사본을 Skills 옆의 .best-ai-skills/backups/로 옮기고 위치를 출력합니다. 별도의 업데이트나 제거 명령어는 없습니다.

간단한 기록을 남기세요

6개월 뒤 누군가 .claude/skills/launch-page/를 발견하고 건드려도 되는지 궁금해할 것입니다. 저장소 README에 네 줄만 적어 두면 답이 됩니다.

README.md
## Agent Skills in this repo
- launch-page: from skillry.dev/skills/bs-meridian-marketing-landing
  version 1.2.0, project scope (.claude/skills), Claude Code
  local change: brand colors in references/palette.md

Skill 업데이트 방법

Skill은 --force로 다시 설치해서 업데이트합니다. CLI가 최신 버전을 내려받아 폴더 전체를 교체하므로, 먼저 읽고 나중에 테스트하세요.

  1. 1

    Skill 페이지에서 무엇이 바뀌었는지 확인하세요. 특히 스크립트, 의존성, 외부 비용을 보세요.

  2. 2

    지난번과 같은 agent나 target으로 --force를 붙여 다시 설치하세요. 플래그가 없으면 CLI는 “already exists. Re-run with --force to replace it safely.”라는 메시지와 함께 멈춥니다.

    터미널
    npx --yes skillry-cli@latest install <slug> --force

    다음이 보여야 합니다: Installed <slug> <version> to …와 Previous version preserved at …

  3. 3

    평소 하던 테스트를 실행하세요. 한 번은 이름으로, 한 번은 평소 말로.

Skill을 로컬에서 수정했나요? --force는 그 수정 사항을 덮어씁니다. 먼저 따로 복사해 두거나, 다시 적용할 수 있도록 references/에 보관하세요.

잘못된 업데이트 롤백하기

강제 설치할 때마다 기존 사본이 Skills 옆에 남습니다. 예: ~/.agents/skills/.best-ai-skills/backups/<slug>-<date>-<id>/. 에이전트는 이 폴더를 로드하지 않습니다. 되돌리려면 현재 <slug>/ 폴더를 삭제하고 백업을 그 자리로 옮긴 뒤 이름을 <slug>로 바꾸세요.

설치가 중간에 실패하면 CLI가 기존 사본을 알아서 복원합니다.

Skill 삭제하기

Skill을 삭제하려면 폴더를 지우세요. 그런 다음 개인 폴더와 프로젝트 폴더에 같은 이름의 다른 사본이 있는지 찾아보세요. Claude Code에서는 개인 사본이 프로젝트 사본보다 우선하므로, 남은 사본 때문에 나중의 업데이트가 무시된 것처럼 보일 수 있습니다. 모든 폴더는 Skill 위치에 정리되어 있습니다.

팀과 사본 하나를 공유하기

검토를 마친 사본 하나를 저장소의 Skills 폴더에 커밋하고 의존성을 기록해 두면 모두가 같은 버전을 실행합니다. Skillry Skill을 그곳에 설치하려면 --target을 사용하세요.

터미널, 저장소 안에서
npx --yes skillry-cli@latest install <slug> --target .claude/skills

자주 묻는 질문

Claude Skills는 어떻게 업데이트하나요?

--force를 붙여 Skillry 설치 명령어를 다시 실행하거나, ~/.claude/skills/의 Skill 폴더 전체를 교체하세요. Claude Code는 현재 세션에서 변경 사항을 인식합니다.

Skill 업데이트가 반영되지 않는 이유는 무엇인가요?

대개 같은 이름의 다른 사본이 다른 곳에 설치되어 있거나 SKILL.md만 교체한 경우입니다. 개인 및 프로젝트 Skill 폴더를 검색해 완전한 사본 하나만 남기세요.

Skill 업데이트를 롤백하려면 어떻게 하나요?

현재 <slug>/ 폴더를 삭제하고 .best-ai-skills/backups/의 백업을 그 자리로 옮긴 뒤 이름을 <slug>로 바꾸세요. 업데이트할 때 CLI가 백업 경로를 출력합니다.

Skill을 제거하려면 어떻게 하나요?

폴더를 삭제하세요. Skillry CLI에는 제거 명령어가 없으므로, 삭제한 뒤 같은 이름의 남은 사본이 없는지 확인하세요.

출처

이 가이드가 도움이 되었나요?