본문으로 건너뛰기

Skill 필터링

Skillshare는 어떤 skill이 어떤 target에 도달하는지 제어하는 세 가지 필터링 계층을 제공합니다. 목표에 맞는 시나리오를 선택하세요.

특정 target에만 skill sync하기

skill의 SKILL.md frontmatter에 metadata.targets(권장)를 추가하세요. 해당 skill은 나열된 target에만 sync됩니다.

---
name: my-cursor-only-skill
metadata:
targets: [cursor]
---

Target alias가 지원됩니다 — claudeclaudeclaude-code 둘 다와 일치합니다.

📖 SKILL.md targets 필드 · 필터링 레퍼런스

특정 target에서 특정 skill 제외하기

glob 패턴과 일치하는 skill을 차단하려면 target에 --add-exclude를 사용하세요.

skillshare target cursor --add-exclude "legacy-*"
skillshare sync

📖 Target 필터 플래그 · 필터링 레퍼런스

하나의 target에서 특정 skill만 허용하기

whitelist를 만들려면 --add-include를 사용하세요 — 일치하는 skill만 sync됩니다.

skillshare target claude --add-include "team-*"
skillshare sync

📖 Target 필터 플래그 · 필터링 레퍼런스

모든 target에서 skill 숨기기

source 디렉터리에 .skillignore 파일을 두세요. 이 패턴과 일치하는 skill은 discovery 시점에 모든 target에서 제외됩니다.

~/.config/skillshare/skills/.skillignore
drafts/
experimental-*

패턴을 추가하거나 제거하는 가장 빠른 방법은 enable / disable 명령어입니다.

skillshare disable experimental-*   # .skillignore에 추가
skillshare enable experimental-* # .skillignore에서 제거

skillshare list TUI에서 E를 눌러 skill을 켜고 끌 수도 있습니다.

📖 enable / disable · .skillignore 문법 · 필터링 레퍼런스

Tracked repo 내부 skill 제외하기

tracked repo 디렉터리 내부에 .skillignore를 두세요. 해당 repo 내의 skill에만 영향을 줍니다.

_team-repo/.skillignore
internal-only/*
validation-scripts

📖 Repo 수준 .skillignore

로컬 전용 재정의

.skillignore.local.skillignore 뒤에 추가됩니다 — 마지막에 일치하는 규칙이 우선합니다. negation 패턴을 사용해 공유 파일을 편집하지 않고 로컬에서 skill의 ignore를 해제하세요.

_team-repo/.skillignore.local
# The repo ignores private-*, but I need mine
!private-mine

이 파일은 커밋하지 마세요 — .gitignore에 추가하세요.

📖 .skillignore.local

어떤 계층을 사용해야 할까요?

필터링되는 항목을 확인하는 방법

명령어표시되는 내용
skillshare sync하단에 무시된 skill 수와 이름
skillshare status --json전체 .skillignore 통계 (패턴, 무시된 skill, 활성 파일)
skillshare doctorhealth check에 .skillignore 패턴 수와 무시된 수 포함
skillshare ui → Sync 페이지배지가 있는 접을 수 있는 "Ignored by .skillignore" 카드

참고