agent-skill-groups
Stop loading every agent skill for every task. Switch skills by runtime and scenario.
A runtime-aware Agent Skills manager for OpenAI Codex, Claude Code, OpenCode, and generic SKILL.md repositories.
Quickstart demo | FAQ | Skill group vs MCP vs plugin | Agent Skills manager comparison | Agent Skills ecosystem map | Ecosystem status report | Visibility status | IndexNow status | Visibility tracking issue | Search phrases | GitHub topic metadata | GitHub search ranking | Search diagnostics | Discovery report | Web search report | GitHub Markdown FAQ | Install guide | llms.txt
What It Is
agent-skill-groups is a GitHub repository and Python CLI for managing large local Agent Skills libraries. It creates skill groups, keeps a small core profile active, writes managed AGENTS.md or CLAUDE.md instruction blocks, and switches scenario groups without editing original skill files.
For terminology, see Skill group vs MCP vs plugin.
Search Terms This Project Serves
GitHub agent skill group, GitHub agent-skill-group, GitHub skill-group, Agent Skills manager, AI agent skills manager, skill manager, skills manager, OpenAI Codex skills manager, Claude Code skills manager, OpenCode skills manager, SKILL.md organizer, runtime-aware skill profiles, scenario-based skill loader, search phrases.
- GitHub skill-group and GitHub agent-skill-group search phrases
- GitHub skill-group manager
- GitHub skill-group
- GitHub agent-skill-group
- Agent Skills manager
- Agent Skills manager comparison
- Agent Skills ecosystem map
- Current ecosystem status report
- Current visibility status
- Current IndexNow crawl notification status
- GitHub search visibility tracking issue
- GitHub skill-group FAQ
- GitHub search ranking notes
- GitHub agent-skill-group search diagnostics
- Current discovery report
- Current web search report
- Machine-readable visibility status JSON
- Machine-readable IndexNow status JSON
Localized Documentation
Language-specific pages keep the GitHub skill-group and GitHub agent-skill-group workflow readable for non-English users while linking back to the same canonical repository.
- 简体中文文档 and Markdown 中文文档
- 日本語ドキュメント and Markdown 日本語文書
- Documentación en español and Markdown en español
Search Alias Pages
These small public entries help people find the same canonical project when they search for GitHub skill-group, GitHub skills group, agent-skill-group, or GitHub agent-skill-group.
- github-skill-group alias page and github-skill-group alias repository
- github-agent-skill-group alias page and github-agent-skill-group alias repository
- agent-skill-group alias page and agent-skill-group alias repository
- github-skills-group alias page and github-skills-group alias repository
- skill-group alias page and skill-group alias repository
- skill-groups alias page and skill-groups alias repository
Core Workflow
agent-skill-groups demo --json
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 memory --config groups.json --runtime codex --write AGENTS.md
python -m agent_skill_groups status --config groups.json --runtime codex --json --details
python -m agent_skill_groups profile --config groups.json --runtime codex ctf-webTry It First
The GitHub skill-group quickstart shows both the one-command demo and the manual copy-paste workflow for two sample SKILL.md directories. The expected JSON shape is available as examples/demo-output.json.
Related Project
The Codex-focused subproject is codex-skill-groups.