skills

このリポジトリは、Jon HillによるポータブルなAgent Skillsの公開コレクションです。各スキルは自己完結型で、モデルやハーネスに依存しない指示であり、AIコーディングエージェントが必要に応じて読み込むことができます。各スキルは個別にインストール可能で、特定のハーネスに固有のものや、プライベートなツールに依存するものはありません。 ## インストール コレクションを閲覧するには `npx skills add jonhill90/skills --list` を実行するか、特定のスキルを現在のプロジェクトにインストールするには `npx skills add jonhill90/skills --skill tmux --skill github-cli` を実行します。`npx skills` CLIは再現性のために、インストール内容を `skills-lock.json` 内でコンテンツハッシュによって固定します。 このリポジトリは、Agent Plugins 1.0.0のプラグイン（ルートに `plugin.json` があり、スキルは `skills/<name>/SKILL.md` に配置）としても機能し、`.claude-plugin/` を介してClaude Codeプラグインとしても機能します。マーケットプレイスを `claude plugin marketplace add jonhill90/skills` で追加し、`claude plugin install jonhill90-skills@jonhill90` でインストールします。このプラグインには固定バージョンがないため、`main` 上の最新コミットを追跡し、コレクション全体を読み込みます（セッションあたり約5.6kトークンのスキル説明）。 ## このコレクションのスキル このコレクションには42個のスキルが含まれ、それぞれにアップロード監査ステータス（PASSまたはFAIL）があり、ローカルマシンやCLIに関する前提が検出されたかどうかを示します。例としては以下のものがあります。 - `ask-a-council` — 複数の視点に相談する - `devils-advocate` — 前提に異議を唱える - `failing-test-first` — テスト駆動開発 - `github-cli` — GitHub CLIの使用 - `obsidian` — Obsidianノート管理 - `prd` — 製品要件ドキュメント - `spec-driven-development` — 仕様優先の開発 - `tdd` — テスト駆動開発 - `tmux` — tmuxターミナルマルチプレクサ - その他、計画、調査、メモリ、安全な削除などのワークフローをカバーする多数のスキル ## スキルの配置場所 READMEでは、ほとんどのスキルはこのリポジトリに置くべきではないと助言しています。配置は使用状況によって異なります。多くの無関係なプロジェクトで役立つスキルは、このような公開コレクションに属します。1つのリポジトリでのみ有効なスキルは、そのリポジトリの `.claude/skills/` または `.agents/skills/` に属します。単発のスキルや外部で保守されているスキルは、`npx skills use <package>@<skill>` を介して直接使用できます。 ## 作成の契約 各スキルは `skills/<name>/SKILL.md` に配置され、オプションで `scripts/`、`references/`、`assets/` ディレクトリを持ちます。ポータブルなフロントマターには `name` と `description`（およびオプションで `license`、`compatibility`、`metadata`、`allowed-tools`）が含まれます。ディレクトリ名は `name` と一致する必要があり、`SKILL.md` は500行未満に保ち、詳細はリンクされた参照に移すべきです。完全な規約は `AGENTS.md` にあります。 ## 検証 リポジトリを検証するには `python3 scripts/validate_repository.py` と `python3 -m unittest discover -s tests -v` を実行します。CIはすべてのプルリクエストと `main` へのプッシュで両方を実行します。 ## コンテンツの境界 このリポジトリには、ポータブルなスキルコンテンツと最小限の検証/テスト/CIのみが含まれます。個人的なハーネス設定（正規の指示、フック、エージェント、設定、MCP宣言、インストール/同期ツール）は、別の個人ハーネスリポジトリにあります。現時点ではここに行動評価システムはありません。コミュニティが保守する代替案はissue #309で追跡されています。雇用主が所有する資料やプロジェクト固有の資料は、ここにコピーされることはありません。