# agent-skill-groups

不要让每一次 Agent 会话都加载全部 skills。按运行时和应用场景切换技能组。

`agent-skill-groups` 是一个 GitHub skill-group / GitHub agent-skill-group 管理器，用来整理本地 Agent Skills 风格的 `SKILL.md` 目录。它支持：

- OpenAI Codex
- Claude Code
- OpenCode
- 通用 `.agents/skills` 布局

## 解决的问题

当本地 skills 越来越多时，真正麻烦的不是安装，而是长期管理：

- 每次会话都加载太多无关 skills
- 启动上下文越来越吵
- CTF、Figma、论文、视频等专用 skills 常驻但并非每次都需要
- 手动移动目录不可维护，也难以复现
- 大型 skill 仓库缺少扫描、分组、诊断、备份和恢复流程

这个项目提供一个场景 profile 层：常驻只保留 `core`，其他能力按需启用。

## 基本流程

```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；任务结束后回到 `core`。

## 搜索关键词

这个项目对应的常见搜索词包括：

- 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

## 相关链接

- GitHub 仓库：https://github.com/go165/agent-skill-groups
- 文档首页：https://go165.github.io/agent-skill-groups/
- 快速演示：https://go165.github.io/agent-skill-groups/quickstart.html
- 可见性状态：https://go165.github.io/agent-skill-groups/visibility-status.html