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.
Install and verify | Quickstart demo | Current-session skill loader | 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
- Current-session skill group loader
- GitHub skill-group manager
- GitHub agent-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.
- Simplified Chinese documentation and Markdown Simplified Chinese documentation
- Japanese documentation and Markdown Japanese documentation
- Spanish documentation and Markdown Spanish documentation
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 session-load --config groups.json --runtime codex ctf-web
python -m agent_skill_groups session-unload --config groups.json --runtime codex ctf-web
python -m agent_skill_groups profile --config groups.json --runtime codex ctf-webTry It First
Use Install and verify to install the GitHub release wheel and run agent-skill-groups self-test --json before touching real skill roots. 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.