skills-add
Skill7 starsChanged 5 days agoMITView on GitHub
外部スキルを GitHub からインストールし skills.lock.json に自動登録する。skillPath を GitHub API で解決し .skills-ignore.json を尊重する。トリガー: /skills-add <url-or-owner/repo>
- Installs packages
In this repository6 other files it gives its agents.
- check-vendor-updatesSkill
- skill-deck-managerSkill
- skills-checkSkill
- skills-restoreSkill
- skills-stateSkill
- vendor-forkSkill
The file
Files
Skills Add
external Skill の取得から selected Catalog の Inventory Lock 更新・コミットまでを自動化する。
Arguments
$0= GitHub URL またはowner/repo形式MY_SKILLS_CATALOG_DIR= 更新対象 Catalog--skill <name>= 特定のスキルのみインストール(省略時は repo 内全スキル)--no-commit= lock.json 更新のみ、コミットしない
$ARGUMENTS が空の場合はユーザーに URL を質問する。
Workflow
Step 1: 引数を確認
$ARGUMENTS から URL を抽出する。空なら質問:
- インストールしたい external skill の GitHub URL または
owner/repoを教えてください
Step 2: スクリプトを実行
MY_SKILLS_CATALOG_DIR="$CATALOG_ROOT" \
bash "$ENGINE_ROOT/.agents/skills/skills-add/scripts/skills-add" $ARGUMENTSスクリプトが自動的に以下を処理する:
npx skills addでインストール- 対象 agent は
claude-code、codex、antigravity - インストール前に source の候補を UI と同じ規則で衝突判定し(
plan-candidates.ts)、衝突しないものだけをインストール。候補が取れなければ失敗として終了 - GitHub API で各 SKILL.md の frontmatter
nameを突合してskillPathを解決 .skills-ignore.jsonに含まれるスキルはスキップ- 同じ名前の skill は 1 つしか管理しない。lock・active・archive のどこかに同名があれば(別 source でも)インストールせず skip し、対話時は skip / Vendor fork を選ぶ。別名や
owner--nameでの共存はしない。入れ替えたいときは既存を外してから add する。同一 source の再 add は skip - Catalog の
skills.lock.jsonに上流名をキーとして追記 - デフォルトで Catalog repository にコミット(
--no-commitでスキップ)
完了基準: スクリプトが exit 0 で終了し、skills.lock.json に新規スキルが追記されていること。追記前に、取得元(source・sourceUrl)、解決済み skillPath、インストールされた SKILL.md が期待したスキルであるかを検証し、検証に失敗した場合は lock への登録と成功報告を行わないこと。
Step 3: 完了報告
登録されたスキル名・source・skillPath を出力してユーザーに報告する。
Troubleshooting
gh: command not found
brew install gh && gh auth loginskillPath がパターンマッチにフォールバックした場合
スクリプトが skills/<name>/SKILL.md をデフォルトとして使用した旨の Warning が表示される。
実際の GitHub repo を確認して手動で修正:
# "$CATALOG_ROOT/skills.lock.json" の skillPath を修正既に登録済みのスキルを上書きしたい場合
Catalog の skills.lock.json から該当エントリを外して再実行する。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

