GitHub skill-group manager for Agent Skills
agent-skill-groups is a GitHub skill-group manager and GitHub agent-skill-group manager for developers who keep many local SKILL.md Agent Skills.
It supports OpenAI Codex, Claude Code, OpenCode, and generic Agent Skills layouts. The tool scans skill folders, suggests scenario groups, writes managed agent memory snippets, renders session-load context packs for the current conversation, backs up state, switches profiles, and restores the original layout.
When To Use It
- You have many Agent Skills and do not want all of them active in every agent session.
- You want repeatable groups such as
core,research,frontend-browser,ctf-web, ordesktop-media. - You need one workflow that can work across Codex, Claude Code, OpenCode, and plain local skill roots.
- You want a small managed block in
AGENTS.mdorCLAUDE.mdso future sessions know how to load and unload skill groups.
Fastest Test
pipx install git+https://github.com/go165/agent-skill-groups.git
agent-skill-groups demo --json
The demo creates a temporary sample skill repository, runs the reversible grouping workflow, and prints ok: true when it can initialize, back up, switch profiles, write memory, and restore successfully.
Current Conversation Loading
Use session-load when the current conversation needs a disabled scenario group immediately. It prints a context pack from active roots or the disabled pool without moving directories.
agent-skill-groups session-load --config groups.json --runtime codex research
Use session-unload later in the same conversation to stop applying that group without moving directories.
agent-skill-groups session-unload --config groups.json --runtime codex research
Use profile only when native filesystem discovery should change after a runtime reload, rescan, or new session.
Core Commands
agent-skill-groups runtimes
agent-skill-groups analyze --runtime codex --json
agent-skill-groups suggest --runtime codex --json
agent-skill-groups init --runtime codex --output groups.json
agent-skill-groups session-load --config groups.json --runtime codex research
agent-skill-groups memory --config groups.json --runtime codex --write AGENTS.md
agent-skill-groups profile --config groups.json --runtime codex research
agent-skill-groups restore --config groups.json --runtime codex backup.json
Search Terms
This page is intended for people searching for github skill-group, github skill-group manager, github agent-skill-group, github agent-skill-group manager, Agent Skills manager, Codex skills manager, Claude Code skills manager, OpenCode skills manager, and SKILL.md manager.