Files
skillshare/website/i18n/ko/docusaurus-plugin-content-docs/current/reference/commands/uninstall.md
T
Willie d741baf333 docs: document unreadable git status and translate recent command changes
uninstall now fails a tracked repo whose git status cannot be read
unless --force, but the command page and built-in skill still described
only the uncommitted-changes check. The recent list, status, sync,
update and uninstall changes were also English-only, while this site
updates every locale alongside the English page.
2026-09-30 02:47:18 +08:00

12 KiB
Raw Blame History

sidebar_position
sidebar_position
3

uninstall

source 디렉터리에서 하나 이상의 skill 또는 tracked repository를 제거합니다. skill은 trash로 이동되어 자동 정리 전까지 7일간 보관됩니다.

skillshare uninstall my-skill              # Remove a single skill
skillshare uninstall a b c --force         # Remove multiple skills at once
skillshare uninstall --all                 # Remove all skills
skillshare uninstall --group frontend      # Remove all skills in a group
skillshare uninstall team-repo             # Remove tracked repository (_ prefix optional)

언제 사용하나요

  • 더 이상 필요 없는 skill을 제거할 때(7일간 trash로 이동)
  • 더 이상 사용하지 않는 tracked repository를 정리할 때
  • skill 그룹 전체를 한 번에 일괄 제거할 때
  • --all로 모든 skill을 한 번에 제거할 때
$ skillshare uninstall css-review

Uninstalling skill
─────────────────────────────────────────
→ Name: frontend/css-review
→ Path: ~/.config/skillshare/skills/frontend/css-review

Are you sure you want to uninstall this skill? [y/N]: y
✓ Uninstalled skill: frontend/css-review
→ Moved to trash (7 days): ~/.local/share/skillshare/trash/frontend/css-review_2026-09-28_12-52-23

  Next Steps
→ Run 'skillshare sync' to update all targets

동작 방식

flowchart TD
    TITLE["skillshare uninstall"]
    S1["1. Resolve targets"]
    S2["2. Pre-flight checks"]
    S3["3. Confirm and move to trash"]
    TITLE --> S1 --> S2 --> S3

옵션

Flag Description
--all source에서 모든 skill 제거(확인 필요)
--group, -G <name> 그룹 내 모든 skill 제거(접두사 매칭, 반복 가능)
--force, -f 확인을 건너뛰고 커밋되지 않은 변경 사항을 무시
--dry-run, -n 변경 없이 미리보기
--project, -p 현재 디렉터리의 project 레벨 config 사용
--global, -g global config 사용(~/.config/skillshare)
--json Global mode: JSON을 출력하고 확인을 건너뜀; dirty한 tracked repository는 여전히 --force가 필요함
--help, -h 도움말 표시

JSON Output

skillshare uninstall my-skill another-skill --json
{
  "removed": ["my-skill", "another-skill"],
  "failed": [],
  "skipped": 0,
  "dry_run": false,
  "duration": "0.089s"
}

--dry-run과 조합하여 미리보기할 수 있습니다.

skillshare uninstall --all --json --dry-run

여러 Skill 제거

한 번의 명령으로 여러 skill을 제거합니다.

skillshare uninstall alpha beta gamma --force

일부 skill을 찾을 수 없는 경우, 명령은 경고와 함께 해당 skill을 건너뛰고 나머지 제거를 계속합니다. 지정된 skill이 모두 유효하지 않은 경우에만 실패합니다.

Glob 패턴

skill 이름은 일괄 제거를 위한 glob 패턴(*, ?, [...])을 지원합니다.

skillshare uninstall "core-*"              # Remove all skills matching core-*
skillshare uninstall "test-?" --force      # Single-character wildcard
skillshare uninstall "core-*" "util-*"     # Multiple patterns

Glob 매칭은 대소문자를 구분하지 않습니다: "Core-*"는 core-auth, CORE-DB 등과 매칭됩니다.

:::note 최상위 레벨 매칭만 지원 Glob 패턴은 source 폴더 내의 최상위 디렉터리 이름에만 매칭됩니다. 중첩된 skill(예: frontend/react-hooks)은 "react-*"로 매칭되지 않습니다 — 하위 디렉터리 내의 skill을 대상으로 하려면 --group frontend를 사용하세요. :::

Remove All

--all을 사용하면 source 디렉터리의 모든 skill을 한 번에 제거합니다.

skillshare uninstall --all                 # Interactive confirmation
skillshare uninstall --all --force         # Skip confirmation
skillshare uninstall --all -n              # Preview what would be removed

--all은 skill 이름이나 --group과 함께 사용할 수 없습니다.

:::tip Shell glob 보호 따옴표 없이 skillshare uninstall *를 실행하면 shell이 *를 현재 디렉터리의 파일 이름으로 확장합니다. skillshare는 이를 감지하고 대신 --all 사용을 제안합니다. 항상 와일드카드에 따옴표("*")를 사용하거나 --all을 사용하세요. :::

Group Removal

하위 skill이 포함된 디렉터리를 제거하면 skillshare는 자동으로 이를 그룹으로 감지하고 확인을 요청하기 전에 포함된 skill을 나열합니다.

Uninstalling group (5 skills)
─────────────────────────────────────────
  - feature-radar
  - feature-radar-archive
  - feature-radar-learn
  - feature-radar-ref
  - feature-radar-scan
→ Name: feature-radar
→ Path: ~/.config/skillshare/skills/feature-radar

Are you sure you want to uninstall this group? [y/N]:

--group 플래그는 접두사 매칭을 사용해 디렉터리 아래의 모든 skill을 제거합니다.

# Remove all skills under frontend/
skillshare uninstall --group frontend

# Also removes nested skills: frontend/react/hooks, frontend/vue/composables
skillshare uninstall --group frontend --force

# Preview what would be removed
skillshare uninstall --group frontend --dry-run

그룹 제거가 적용되면(자동 감지된 디렉터리 그룹 포함) 제거된 각 구성원도 config의 관리되는 skills: 목록(~/.config/skillshare/config.yaml 또는 project mode의 .skillshare/config.yaml)에서 제거됩니다.

위치 인수(이름)와 --group을 조합할 수 있으며, -G를 여러 번 사용할 수도 있습니다.

# Mix names and groups
skillshare uninstall standalone-skill -G frontend -G backend --force

# Duplicates are automatically deduplicated
skillshare uninstall frontend/hooks -G frontend --force  # hooks removed once

Tracked Repositories

tracked repository(_로 시작하는 폴더)의 경우:

  • 커밋되지 않은 변경 사항을 확인합니다(재정의하려면 --force 사용)
  • skillshare가 repo의 git status를 읽을 수 없으면 failed to check git status로 실패합니다. 배치의 다른 항목은 계속 제거되며, --force를 사용하면 이 확인을 건너뜁니다
  • .gitignore에서 항목을 자동으로 제거합니다
  • uninstall 시 _ 접두사는 선택 사항입니다
skillshare uninstall _team-skills        # With prefix
skillshare uninstall team-skills         # Without prefix (auto-detected)
skillshare uninstall _team-skills --force # Force remove with uncommitted changes

예시

# Remove a single skill
skillshare uninstall my-skill

# Remove multiple skills
skillshare uninstall skill-a skill-b skill-c --force

# Remove all skills
skillshare uninstall --all
skillshare uninstall --all --force
skillshare uninstall --all -n              # Preview

# Remove by group
skillshare uninstall --group frontend --force

# Preview removal
skillshare uninstall my-skill --dry-run
skillshare uninstall --group frontend -n

# Remove tracked repository
skillshare uninstall team-repo

# Mix names and groups
skillshare uninstall my-skill -G frontend --force

안전성

제거된 skill은 영구 삭제되지 않고 trash로 이동됩니다.

  • 위치: ~/.local/share/skillshare/trash/(global) 또는 .skillshare/trash/(project)
  • 보관 기간: 7일 후 자동으로 정리됨
  • 재설치 힌트: skill이 remote source에서 설치된 경우, 재설치 명령이 표시됨
  • 복원: trash에서 복구하려면 skillshare trash restore <name> 사용

단일 skill(verbose):

✓ Uninstalled skill: my-skill
ℹ Moved to trash (7 days): ~/.local/share/skillshare/trash/my-skill_2026-01-20_15-30-00
ℹ Reinstall: skillshare install github.com/user/repo/my-skill

여러 skill(batch):

✓ Uninstalled 4 skill(s) (0.1s)

── Removed ─────────────────────────────
✓ pdf        skill
✓ tdd        skill
✓ security   group, 2 skills
✗ bad-skill  failed to move to trash: ...

── Next Steps ──────────────────────────
ℹ Moved to trash (7 days).
ℹ Run 'skillshare sync' to update all targets

대량 배치는 축약된 형식을 사용합니다.

✓ Uninstalled 920, failed 2 (1.2s)

── Failed ──────────────────────────────
✗ bad-a  failed to move to trash: permission denied
✗ bad-b  failed to move to trash: permission denied

── Removed ─────────────────────────────
✓ 920 uninstalled

── Next Steps ──────────────────────────
ℹ Moved to trash (7 days).
ℹ Run 'skillshare sync' to update all targets

실수로 제거한 skill을 복원하려면:

skillshare trash list                  # See what's in trash
skillshare trash restore my-skill      # Restore to source
skillshare sync                        # Sync back to targets

Uninstall 이후

skillshare sync를 실행해 모든 target에서 skill을 제거하세요.

skillshare uninstall old-skill
skillshare sync  # Remove from Claude, Cursor, etc.

Project Mode

project의 .skillshare/skills/에서 skill 또는 tracked repo를 제거합니다.

skillshare uninstall my-skill -p                  # Remove a skill
skillshare uninstall a b c -p -f                  # Remove multiple skills
skillshare uninstall --all -p -f                   # Remove all project skills
skillshare uninstall --group frontend -p -f        # Remove a group
skillshare uninstall team-skills -p                # Tracked repo (_ prefix optional)

Project mode에서 uninstall은 다음을 수행합니다.

  • skill 디렉터리를 .skillshare/trash/로 이동합니다(7일간 보관)
  • .skillshare/config.yaml의 skills: 목록에서 skill 항목을 제거합니다(remote skill의 경우)
  • .skillshare/.gitignore에서 항목을 제거합니다(remote/tracked skill의 경우)
  • .skillshare/skills.lock.json에서 skill의 고정을 제거합니다(group의 경우 그 아래의 모든 고정)
  • tracked repo의 경우: 커밋되지 않은 변경 사항을 확인하고, git status를 읽을 수 없으면 실패합니다(둘 다 재정의하려면 --force 사용)
  • _ 접두사는 선택 사항입니다 — 자동 감지됨
skillshare uninstall pdf -p
skillshare sync
git add .skillshare/ && git commit -m "Remove pdf skill"

Agent Support

skill 대신 agent를 제거하려면 --kind agent를 사용하세요.

skillshare uninstall --kind agent tutor              # Remove an agent
skillshare uninstall --kind agent tutor reviewer -f   # Remove multiple agents
skillshare uninstall --kind agent --all               # Remove all agents

Agent uninstall은 skill과 동일한 trash-and-retain 동작을 따릅니다(trash로 이동, 7일간 보관). 배경 지식은 Agents를 참조하세요.

참고