メインコンテンツまでスキップ

Skill のフィルタリング

skillshare は、どの Skill がどの Target に届くかを制御する3つのフィルタリングレイヤーを提供します。 自分の目的に合ったシナリオを選んでください。

Skill を特定の Target にのみ Sync する​

Skill の SKILL.md のフロントマターに metadata.targets（推奨）を追加します。 その Skill は列挙された Target にのみ Sync されます。

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

Target のエイリアスに対応しています — claude は claude と claude-code の両方に一致します。

📖 SKILL.md targets フィールド ・ フィルタリングリファレンス

1つの Target から特定の Skill を除外する​

Target に対して --add-exclude を使い、glob パターンに一致する Skill をブロックします。

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

📖 Target フィルターフラグ ・ フィルタリングリファレンス

1つの Target で特定の Skill のみを許可する​

--add-include を使ってホワイトリストを作成します — 一致する Skill のみが Sync されます。

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

📖 Target フィルターフラグ ・ フィルタリングリファレンス

すべての Target から Skill を隠す​

Source ディレクトリに .skillignore ファイルを置きます。これらのパターンに一致する Skill は、発見時にすべての 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 を置きます。これはそのリポジトリ内の Skill にのみ影響します。

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

📖 リポジトリレベルの .skillignore

ローカル専用のオーバーライド​

.skillignore.local は .skillignore の後に追加されます — 最後に一致したルールが優先されます。共有ファイルを編集せずにローカルで Skill を無視解除するには、否定パターンを使います。

_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 doctorヘルスチェックに .skillignore のパターン数と無視数を含む
skillshare ui → Sync ページバッジ付きの折りたたみ可能な「Ignored by .skillignore」カード

関連項目​