使い方
- インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
- 必要なツール、認証情報、対応環境を原文で確認します。
- 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/philtzjp/skills --skill skill-selection開始前の確認
- 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
- スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。
skill-selection
方針
philtzjp/skills のスキルは、各メンバーのホームに npx skills で導入します。作業対象リポジトリにはコピーしません。
ホームに入れたスキルは、そのメンバーのすべてのリポジトリの作業に効きます。導入も削除も、ユーザーの許可を得てから行ってください。
既定のスキル
全員が入れるスキルは次の 3 つです。
- github
- japanese
- turborepo
DISABLE_TELEMETRY=1 npx skills add philtzjp/skills -g -a claude-code -a codex -a cursor -s github -s japanese -s turborepo -y実体は ~/.agents/skills/<スキル名>/ に置かれ、~/.claude/skills/<スキル名> からシンボリックリンクが張られます。Codex と Cursor は前者を、Claude Code は後者を読みます。
作業に応じて追加するスキル
実際にその作業をするときに追加します。「いつか使うかもしれない」段階では入れないでください。読み込まれるスキルが増えるほど、関係のない規約が作業に混ざります。
| スキル | 追加する場面 |
|---|---|
| hono | HTTP API を設計・実装する |
| db | データベースの選定、スキーマ、接続、マイグレーション、データ移行を扱う |
| e2etest | E2E テストを作成・実行する |
| analytics | アクセス解析や同意管理を実装する |
| errorpage | エラー応答やエラーページを設計する |
| cursor-hook-authoring | Cursor Cloud Agent の Git hook 連鎖を扱う |
| knowledge-elicitation | 対話でユーザーの暗黙知を引き出す |
| m4l-project | Max for Live デバイスを扱う |
一覧は増えることがあります。最新の一覧は次で確認してください。
DISABLE_TELEMETRY=1 npx skills add philtzjp/skills --list追加するときは、スキル名だけを指定します。
DISABLE_TELEMETRY=1 npx skills add philtzjp/skills -g -a claude-code -a codex -a cursor -s <スキル名> -yrefresh-skills、skill-selection、skill-escalation は導入しません。スキルの追加、削除、更新、移行は npx skills を直接使って行います。手順は https://raw.githubusercontent.com/philtzjp/startingpoint/main/START.md にあります。
入れないスキル
次は統合済みの旧スキルで、中身は統合先への案内だけです。導入しないでください。
| 旧スキル | 代わりに入れるスキル |
|---|---|
| commit-and-git、issue-branch-pr-flow | github |
| japanese-writing | japanese |
| typescript-monorepo | turborepo |
| api-design | hono |
| data-migration | db |
| e2e-testing | e2etest |
| google-analytics | analytics |
外す
使わなくなったスキルは、ユーザーの許可を得てから外します。
DISABLE_TELEMETRY=1 npx skills remove -g -y <スキル名>既定の 3 つは外さないでください。
リポジトリ固有のスキルを置くか
そのリポジトリでしか意味を持たない規約は、ホームではなくリポジトリに置いてかまいません。
- まず、AGENTS.md に数行書けば足りないかを考える。足りるなら AGENTS.md に書く。
- スキルにするなら、
.agents/skills/<スキル名>/SKILL.mdに正本を置き、.claude/skills/<スキル名>から相対シンボリックリンクを張り、AGENTS.md のスキル表に行を足す。突き合わせの手順は refresh-skills に書いてある。 - philtzjp/skills と同じ名前にしない。
- 他のリポジトリでも役立つと分かったら、skill-escalation に従って philtzjp/skills への追加を提案する。
AGENTS.md には、導入していないスキルを前提にした規約を書かないでください。
