GitHub skill-group quickstart

Install

Install from the latest verified GitHub release wheel:

python -m pip install https://github.com/go165/agent-skill-groups/releases/download/v0.3.32/agent_skill_groups-0.3.32-py3-none-any.whl
agent-skill-groups runtimes

Run The One-Command Demo

The fastest check is the built-in demo. It creates a sample skill repository under a demo directory, runs the full reversible workflow, and prints machine-readable checks.

agent-skill-groups demo --json

Run The Manual Clean Demo

The demo creates two local skills, generates a group table, previews a profile switch, writes an agent memory block, moves one skill into the active root, and restores the original state.

tmp="$(mktemp -d)"
mkdir -p "$tmp/active/agent-reach" "$tmp/disabled/figma-use"

cat > "$tmp/active/agent-reach/SKILL.md" <<'EOF'
---
name: agent-reach
description: Internet research search skill
---
# agent-reach
EOF

cat > "$tmp/disabled/figma-use/SKILL.md" <<'EOF'
---
name: figma-use
description: Figma design implementation skill
---
# figma-use
EOF

agent-skill-groups init \
  --active-root "$tmp/active" \
  --disabled-root "$tmp/disabled" \
  --output "$tmp/groups.json"

agent-skill-groups backup \
  --config "$tmp/groups.json" \
  --output "$tmp/backup.json"

agent-skill-groups plan \
  --config "$tmp/groups.json" \
  figma-design

agent-skill-groups memory \
  --config "$tmp/groups.json" \
  --runtime generic \
  --write "$tmp/AGENTS.md"

agent-skill-groups profile \
  --config "$tmp/groups.json" \
  figma-design

test -d "$tmp/active/figma-use"

agent-skill-groups restore \
  --config "$tmp/groups.json" \
  "$tmp/backup.json"

test -d "$tmp/disabled/figma-use"

What This Proves

• init can create a usable groups.json from real SKILL.md directories.
• plan shows the filesystem change before it happens.
• memory --write creates a managed AGENTS.md instruction block for future agent sessions.
• profile moves only the selected scenario skill into the active root.
• restore returns the skill repository to its prior state.

More

Read the real-world test plan, install guide, or the v0.3.32 release.

Search aliases: GitHub skill-group and GitHub agent-skill-group.