github-agent-skill-group-manager.html

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>GitHub agent-skill-group manager - agent-skill-groups</title>
  <meta name="description" content="Agent skill groups manager, GitHub agent-skill-group manager, and GitHub skill-group manager for verifying, grouping, and switching SKILL.md Agent Skills across OpenAI Codex, Claude Code, OpenCode, and generic runtimes.">
  <meta name="keywords" content="agent skill groups manager, agent-skill-groups manager, github agent-skill-group manager, github skill-group manager, agent-skill-groups, Agent Skills manager, Codex skills manager, Claude Code skills manager, OpenCode skills manager, SKILL.md manager">
  <meta name="robots" content="index, follow">
  <meta property="og:type" content="website">
  <meta property="og:title" content="GitHub agent-skill-group manager - agent-skill-groups">
  <meta property="og:description" content="A scriptable Agent Skills manager for scenario profiles, install self-tests, AGENTS.md/CLAUDE.md snippets, and reversible skill switching.">
  <meta property="og:url" content="https://go165.github.io/agent-skill-groups/github-agent-skill-group-manager.html">
  <link rel="canonical" href="https://go165.github.io/agent-skill-groups/github-agent-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-agent-skill-group-manager.html#page",
        "name": "GitHub agent-skill-group manager",
        "url": "https://go165.github.io/agent-skill-groups/github-agent-skill-group-manager.html",
        "description": "Agent skill groups manager, GitHub agent-skill-group manager, and GitHub skill-group manager for Agent Skills repositories.",
        "about": [
          "GitHub agent-skill-group manager",
          "GitHub skill-group manager",
          "agent skill groups manager",
          "agent-skill-groups manager",
          "Agent Skills manager",
          "SKILL.md manager",
          "install self-test",
          "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": "agent skill groups manager, agent-skill-groups manager, github agent-skill-group manager, github skill-group manager, Agent Skills manager, OpenAI Codex, Claude Code, OpenCode, SKILL.md, self-test",
        "url": "https://go165.github.io/agent-skill-groups/"
      },
      {
        "@type": "FAQPage",
        "@id": "https://go165.github.io/agent-skill-groups/github-agent-skill-group-manager.html#faq",
        "mainEntity": [
          {
            "@type": "Question",
            "name": "What does a GitHub agent-skill-group manager do?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "It organizes Agent Skills stored in GitHub repositories or local SKILL.md folders into scenario groups, then can render a session-load context pack for the current conversation or switch only the needed groups into the active runtime skill root."
            }
          },
          {
            "@type": "Question",
            "name": "How can I verify the install before touching real skills?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Run agent-skill-groups self-test --json. It creates a temporary demo layout, runs version, demo, validate, status, and memory checks, then reports whether the installed CLI works end to end."
            }
          }
        ]
      }
    ]
  }
  </script>
</head>
<body>
  <main>
    <h1>GitHub agent-skill-group manager</h1>
    <p><strong>agent-skill-groups</strong> is an agent skill groups manager, GitHub agent-skill-group manager, and GitHub skill-group manager for local <code>SKILL.md</code> Agent Skills libraries.</p>
    <p>It is built for OpenAI Codex, Claude Code, OpenCode, and generic Agent Skills layouts. The CLI scans installed skills, suggests scenario groups, writes managed runtime instructions, renders <code>session-load</code> and <code>session-unload</code> packs for the current conversation, switches profiles, backs up state, and restores the original layout.</p>

    <h2>Current Conversation Loading</h2>
    <p>Use <code>session-load</code> when an already-running conversation needs a scenario group immediately. It reads <code>SKILL.md</code> files from active roots or the disabled pool and prints a context pack 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>Install Self-Test</h2>
    <p>Use the self-test before touching a real skill directory:</p>
    <pre><code>python -m pip install https://github.com/go165/agent-skill-groups/releases/download/v0.3.52/agent_skill_groups-0.3.52-py3-none-any.whl
agent-skill-groups self-test --json</code></pre>
    <p>The command creates a temporary sample repository and verifies the installed command path, demo workflow, validation, status output, and managed memory snippet.</p>

    <h2>Common Scenario Groups</h2>
    <ul>
      <li><code>core</code> for daily work.</li>
      <li><code>research</code> for web research, PDFs, notebooks, and search tools.</li>
      <li><code>frontend-browser</code> for browser automation, screenshots, and UI work.</li>
      <li><code>ctf-web</code>, <code>ctf-crypto</code>, and <code>ctf-pwn-reverse</code> for challenge workflows.</li>
      <li><code>desktop-media</code> for WinUI, desktop, and local media tasks.</li>
    </ul>

    <h2>Core Commands</h2>
    <pre><code>agent-skill-groups runtimes
agent-skill-groups self-test --json
agent-skill-groups init --runtime codex --output groups.json
agent-skill-groups status --config groups.json --runtime codex --json --details
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 discovery --json</code></pre>

    <h2>Related Search Pages</h2>
    <ul>
      <li><a href="github-skill-group-manager.html">GitHub skill-group manager</a></li>
      <li><a href="agent-skills-manager.html">Agent Skills manager</a></li>
      <li><a href="search-phrases.html">Search phrase index</a></li>
      <li><a href="search-diagnostics.html">GitHub search diagnostics</a></li>
      <li><a href="visibility-status.html">Visibility status</a></li>
      <li><a href="https://github.com/go165/agent-skill-groups">Canonical GitHub repository</a></li>
    </ul>
  </main>
</body>
</html>