# Skills Add

> 外部スキルを GitHub からインストールし skills.lock.json に自動登録する。skillPath を GitHub API で解決し .skills-ignore.json を尊重する。トリガー: /skills-add <url-or-owner/repo>

- **Type:** Skill
- **Install:** `agentstack add skill-yunosukeyoshino-skill-loom-skills-add`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [YunosukeYoshino](https://agentstack.voostack.com/s/yunosukeyoshino)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [YunosukeYoshino](https://github.com/YunosukeYoshino)
- **Source:** https://github.com/YunosukeYoshino/skill-loom/tree/main/.agents/skills/skills-add

## Install

```sh
agentstack add skill-yunosukeyoshino-skill-loom-skills-add
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skills Add

external Skill の取得から selected Catalog の Inventory Lock 更新・コミットまでを自動化する。

## Arguments

- `$0` = GitHub URL または `owner/repo` 形式
- `MY_SKILLS_CATALOG_DIR` = 更新対象 Catalog
- `--skill ` = 特定のスキルのみインストール（省略時は repo 内全スキル）
- `--no-commit` = lock.json 更新のみ、コミットしない

`$ARGUMENTS` が空の場合はユーザーに URL を質問する。

## Workflow

### Step 1: 引数を確認

`$ARGUMENTS` から URL を抽出する。空なら質問:

- インストールしたい external skill の GitHub URL または `owner/repo` を教えてください

### Step 2: スクリプトを実行

```bash
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`
- インストール前後の差分で新規スキルを検出
- GitHub API で各 SKILL.md の frontmatter `name` を突合して `skillPath` を解決
- `.skills-ignore.json` に含まれるスキルはスキップ
- 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`**

```bash
brew install gh && gh auth login
```

**skillPath がパターンマッチにフォールバックした場合**

スクリプトが `skills//SKILL.md` をデフォルトとして使用した旨の Warning が表示される。
実際の GitHub repo を確認して手動で修正:

```bash
# "$CATALOG_ROOT/skills.lock.json" の skillPath を修正
```

**既に登録済みのスキルを上書きしたい場合**

Catalog の `skills.lock.json` から該当エントリを外して再実行する。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [YunosukeYoshino](https://github.com/YunosukeYoshino)
- **Source:** [YunosukeYoshino/skill-loom](https://github.com/YunosukeYoshino/skill-loom)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-yunosukeyoshino-skill-loom-skills-add
- Seller: https://agentstack.voostack.com/s/yunosukeyoshino
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.