setup-falcondev-oss-skills について
setup-falcondev-oss-skillsは、指定スキルの導入とエージェントハーネスの設定を行うプロンプト駆動型スキルです。既存の導入状況とハーネスを検出し、変更前に確認を取り、設定を冪等に実行します。
主な機能
- 01導入済みスキルとエージェントハーネスの検出
- 02計画の提示と事前の同意取得
- 03ponytail、指定範囲のMatt Pocockスキル、リポジトリ内スキルの導入
- 04検出したハーネス設定へのstanding-orders追加
- 05既存設定の保持
- 06繰り返し実行しても変更を重ねない仕組み
活用シーン
- 01新しいマシンでスキルを設定
- 02未導入のスキルだけを追加
- 03設定済みハーネスにstanding-ordersを共通設定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/setup-falcondev-oss-skillsを入力して読み込まれたか確認します。
同梱ファイルinstall.sh
詳細
falcondev-oss/skills のセットアップ
このマシンが常に適切なスキルを使えるようにセットアップします。次の4つを行います。何かに手を加える前に、それぞれをユーザーに説明して、承認を得てください。
- root ponytail スキルをインストールします。あらゆるコーディング作業で、最も手間のかからない解決策を優先するためのルールです。（ponytail リポジトリには
ponytail-audit、-review、-helpなどもありますが、セットアップではルートのponytailのみをインストールします。） - Matt Pocock のスキルをインストールします。リポジトリの「Mattpocock Skills」セクションのみが対象で、「Other」セクションは対象外です。
- このリポジトリ（
falcondev-oss/skills）のすべてのスキルをインストールします。standing-orders、conventional-commits などが含まれます。 - standing-orders をすべてのエージェントハーネスのルート設定ファイルに追加します。これにより、すべての会話で、コード作業では ponytail を、git を使う前には conventional-commits をデフォルトで適用します。
これはプロンプト主導であり、スクリプトではありません。検出し、計画を提示し、承認を得てから実行します。各ステップは冪等です。再実行しても、すでに適用済みのものは変更されません。
1. 検出
- 以下のスキルのうち、すでにインストールされているものはどれですか？（
pnpm dlx skills@latest ls -g、または使用中のパッケージマネージャーに相当するコマンドを使います。） - ユーザーが使っているハーネスはどれですか？各設定ディレクトリを確認します：
~/.claude（Claude Code）、~/.codex（Codex）、~/.gemini（Gemini CLI）、~/.cursor（Cursor）、~/.config/opencode（opencode）。standing-orders の行は、存在するすべてのディレクトリに追加します。
2. 計画の提示
実行内容をユーザーに伝え、承認を得ます。該当スキルがすでにインストールされている場合は、インストールを省略します。
install.shは、ルートのponytailスキル、Matt Pocock の「Mattpocock Skills」セクションにある22個のスキル（「Other」は対象外）、およびこのリポジトリのすべてのスキルをグローバルにインストールします。--skillで正確なスキル名を指定するため、対話式のカテゴリ選択はスキップされます。ユーザーのパッケージマネージャー（pnpm／yarn／bun／npm）を通じて skills CLI を実行するため、システムにグローバルインストールされるものはありません。- ステップ4では、検出された各ハーネスのルート設定ファイルに standing-orders の行を追加します。
3. インストール
このスキルの install.sh を実行し、ステップ1で検出したハーネスごとに -a を1つ渡します。
bash install.sh -a claude-code -a codex # one -a per detected harness
PM=pnpm bash install.sh -a claude-code # force a package manager (default: auto-detect)
追加の引数はすべての skills add に渡されます。-a を省略すると、サポートされているすべてのエージェントにインストールされます。この方法でも問題ありませんが、グローバルインストールに対応していないエージェント（例：PromptScript）は、無害な警告を表示してスキップされます。上記の3つのグループがインストールされれば完了です。
4. 各ハーネスに standing-orders を追加
ステップ1で検出した各ハーネスのルート設定ファイルに、次の行を単独の行として記述します。
In every conversation, follow the `standing-orders` skill.
ハーネスごとのルート設定ファイル：
| ハーネス | ルート設定ファイル |
|---|---|
| Claude Code | ~/.claude/CLAUDE.md |
| Gemini CLI | ~/.gemini/GEMINI.md |
| Codex、Cursor、opencode、その他のエージェント | エージェントの設定ディレクトリにある AGENTS.md（例：~/.codex/AGENTS.md） |
ファイルが存在しない場合は作成します。行がすでに記述されている場合はそのままにし、ファイル内の他の指示には一切手を加えません。
5. 完了
インストールされたスキルと、行が追加されたハーネス設定ファイルをユーザーに伝えます。これ以降、すべての会話で、コーディング作業には ponytail が、git の命名を行う前には conventional-commits が適用されます。