agent-skill-groups/docs/github-skill-group-manager.html at main · go165/agent-skill-groups · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>GitHub skill-group manager for Agent Skills - agent-skill-groups</title>
  <meta name="description" content="GitHub skill-group manager and GitHub agent-skill-group manager for organizing SKILL.md Agent Skills into scenario profiles for OpenAI Codex, Claude Code, OpenCode, and generic agent runtimes.">
  <meta name="keywords" content="github skill-group manager, github agent-skill-group manager, agent-skill-groups, Agent Skills manager, Codex skills manager, Claude Code skills manager, OpenCode skills manager, SKILL.md manager, scenario skill profiles">
  <meta name="robots" content="index, follow">
  <meta property="og:type" content="website">
  <meta property="og:title" content="GitHub skill-group manager - agent-skill-groups">
  <meta property="og:description" content="A practical Agent Skills manager for switching SKILL.md skills by runtime and scenario instead of loading every skill in every session.">
  <meta property="og:url" content="https://go165.github.io/agent-skill-groups/github-skill-group-manager.html">
  <link rel="canonical" href="https://go165.github.io/agent-skill-groups/github-skill-group-manager.html">
  <style>
    body { font-family: system-ui, -apple-system, Segoe UI, sans-serif; line-height: 1.55; max-width: 880px; margin: 48px auto; padding: 0 20px; color: #1f2937; }
    h1 { font-size: 2rem; line-height: 1.2; }
    code { background: #f3f4f6; padding: 0.12rem 0.25rem; border-radius: 4px; }
    pre { background: #f6f8fa; padding: 16px; overflow-x: auto; border-radius: 6px; }
    a { color: #0969da; }
  </style>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "WebPage",
        "@id": "https://go165.github.io/agent-skill-groups/github-skill-group-manager.html#page",
        "name": "GitHub skill-group manager",
        "url": "https://go165.github.io/agent-skill-groups/github-skill-group-manager.html",
        "description": "GitHub skill-group manager and GitHub agent-skill-group manager for Agent Skills repositories.",
        "about": [
          "GitHub skill-group manager",
          "GitHub agent-skill-group manager",
          "Agent Skills manager",
          "SKILL.md manager",
          "scenario skill profiles"
        ],
        "isPartOf": {
          "@type": "WebSite",
          "name": "agent-skill-groups",
          "url": "https://go165.github.io/agent-skill-groups/"
        },
        "mainEntity": {"@id": "https://github.com/go165/agent-skill-groups#source"}
      },
      {
        "@type": "SoftwareSourceCode",
        "@id": "https://github.com/go165/agent-skill-groups#source",
        "name": "agent-skill-groups",
        "codeRepository": "https://github.com/go165/agent-skill-groups",
        "programmingLanguage": "Python",
        "applicationCategory": "DeveloperApplication",
        "keywords": "github skill-group manager, github agent-skill-group manager, Agent Skills manager, OpenAI Codex, Claude Code, OpenCode, SKILL.md",
        "url": "https://go165.github.io/agent-skill-groups/"
      },
      {
        "@type": "FAQPage",
        "@id": "https://go165.github.io/agent-skill-groups/github-skill-group-manager.html#faq",
        "mainEntity": [
          {
            "@type": "Question",
            "name": "What is a GitHub skill-group manager?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "A GitHub skill-group manager organizes SKILL.md Agent Skills from GitHub or local folders into scenario profiles so an agent runtime loads only the skills needed for the current task."
            }
          },
          {
            "@type": "Question",
            "name": "Is agent-skill-groups an MCP server or a plugin?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "agent-skill-groups is primarily a CLI and repository organizer for Agent Skills. It can ship a small plugin entry, but the core model is runtime-aware skill grouping, not an MCP tool server."
            }
          }
        ]
      }
    ]
  }
  </script>
</head>
<body>
  <main>
    <h1>GitHub skill-group manager for Agent Skills</h1>
    <p><strong>agent-skill-groups</strong> is a GitHub skill-group manager and GitHub agent-skill-group manager for developers who keep many local <code>SKILL.md</code> Agent Skills.</p>
    <p>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 <code>session-load</code> context packs for the current conversation, backs up state, switches profiles, and restores the original layout.</p>

    <h2>When To Use It</h2>
    <ul>
      <li>You have many Agent Skills and do not want all of them active in every agent session.</li>
      <li>You want repeatable groups such as <code>core</code>, <code>research</code>, <code>frontend-browser</code>, <code>ctf-web</code>, or <code>desktop-media</code>.</li>
      <li>You need one workflow that can work across Codex, Claude Code, OpenCode, and plain local skill roots.</li>
      <li>You want a small managed block in <code>AGENTS.md</code> or <code>CLAUDE.md</code> so future sessions know how to load and unload skill groups.</li>
    </ul>

    <h2>Fastest Test</h2>
    <pre><code>pipx install git+https://github.com/go165/agent-skill-groups.git
agent-skill-groups demo --json</code></pre>
    <p>The demo creates a temporary sample skill repository, runs the reversible grouping workflow, and prints <code>ok: true</code> when it can initialize, back up, switch profiles, write memory, and restore successfully.</p>

    <h2>Current Conversation Loading</h2>
    <p>Use <code>session-load</code> 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.</p>
    <pre><code>agent-skill-groups session-load --config groups.json --runtime codex research</code></pre>
    <p>Use <code>session-unload</code> later in the same conversation to stop applying that group without moving directories.</p>
    <pre><code>agent-skill-groups session-unload --config groups.json --runtime codex research</code></pre>
    <p>Use <code>profile</code> only when native filesystem discovery should change after a runtime reload, rescan, or new session.</p>

    <h2>Core Commands</h2>
    <pre><code>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</code></pre>

    <h2>Search Terms</h2>
    <p>This page is intended for people searching for <code>github skill-group</code>, <code>github skill-group manager</code>, <code>github agent-skill-group</code>, <code>github agent-skill-group manager</code>, <code>Agent Skills manager</code>, <code>Codex skills manager</code>, <code>Claude Code skills manager</code>, <code>OpenCode skills manager</code>, and <code>SKILL.md manager</code>.</p>

    <h2>Next Links</h2>
    <ul>
      <li><a href="https://github.com/go165/agent-skill-groups">Canonical GitHub repository</a></li>
      <li><a href="./">Project overview</a></li>
      <li><a href="quickstart.html">Quickstart demo</a></li>
      <li><a href="concepts.html">Skill group vs MCP vs plugin</a></li>
      <li><a href="comparison.html">Agent Skills manager comparison</a></li>
      <li><a href="search-phrases.html">Search phrase index</a></li>
      <li><a href="visibility-status.html">Visibility status</a></li>
    </ul>
  </main>
</body>
</html>