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

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.

Next Links