# agent-skill-groups

すべての Agent skill を毎回のセッションで読み込むのではなく、実行環境と用途に合わせて skill group を切り替えます。

`agent-skill-groups` は、Agent Skills 形式の `SKILL.md` ディレクトリを整理する GitHub skill-group / GitHub agent-skill-group マネージャーです。次の環境を対象にしています。

- OpenAI Codex
- Claude Code
- OpenCode
- 汎用 `.agents/skills` レイアウト

## 解決する問題

ローカルの skills が増えると、問題はインストールではなく運用になります。

- 毎回のセッションで不要な skills まで読み込まれる
- 起動時のコンテキストが大きくなりすぎる
- CTF、Figma、論文、動画などの専門 skills が常時有効になる
- 手作業でフォルダーを移動する方法は再現しにくい
- 大きな skill リポジトリには、スキャン、分類、診断、バックアップ、復元が必要になる

このプロジェクトは scenario profile レイヤーを提供します。常時有効にするのは小さな `core` だけにして、必要なときだけ追加の profile を有効化します。

## 基本フロー

```bash
python -m agent_skill_groups runtimes
python -m agent_skill_groups analyze --runtime codex --json
python -m agent_skill_groups suggest --runtime codex
python -m agent_skill_groups init --runtime codex --output groups.json
python -m agent_skill_groups doctor --config groups.json --runtime codex
python -m agent_skill_groups plan --config groups.json --runtime codex ctf-web
python -m agent_skill_groups backup --config groups.json --runtime codex
python -m agent_skill_groups profile --config groups.json --runtime codex ctf-web
```

## 推奨される使い方

通常は `core` profile だけを有効にします。作業に必要なときだけ、`research`、`frontend-browser`、`ctf-web` などの scenario profile に切り替えます。

## 検索キーワード

このプロジェクトは、次の検索意図に対応しています。

- GitHub skill-group
- GitHub agent-skill-group
- GitHub agent skill group
- Agent Skills manager
- Codex skills manager
- Claude Code skills manager
- OpenCode skills manager
- skill manager
- skills manager
- SKILL.md organizer

## Links

- GitHub repository: https://github.com/go165/agent-skill-groups
- Documentation: https://go165.github.io/agent-skill-groups/
- Quickstart: https://go165.github.io/agent-skill-groups/quickstart.html
- Visibility status: https://go165.github.io/agent-skill-groups/visibility-status.html