-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathquickstart.html
More file actions
154 lines (137 loc) · 6.47 KB
/
Copy pathquickstart.html
File metadata and controls
154 lines (137 loc) · 6.47 KB
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
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>GitHub skill-group quickstart - agent-skill-groups demo</title>
<meta name="description" content="Copy-paste quickstart for agent-skill-groups, a GitHub skill-group and GitHub agent-skill-group manager for Codex, Claude Code, OpenCode, and local Agent Skills repositories.">
<meta name="keywords" content="GitHub skill-group quickstart, GitHub agent-skill-group demo, agent-skill-groups tutorial, Agent Skills manager quickstart, Codex skills manager demo">
<meta name="robots" content="index, follow">
<meta property="og:type" content="article">
<meta property="og:title" content="GitHub skill-group quickstart - agent-skill-groups demo">
<meta property="og:description" content="Run a reversible local Agent Skills workflow with session-load, session-unload, profile, backup, and restore.">
<meta property="og:url" content="https://go165.github.io/agent-skill-groups/quickstart.html">
<meta name="twitter:card" content="summary">
<link rel="canonical" href="https://go165.github.io/agent-skill-groups/quickstart.html">
<style>
body { font-family: system-ui, -apple-system, Segoe UI, sans-serif; line-height: 1.55; max-width: 920px; margin: 48px auto; padding: 0 20px; color: #1f2937; }
h1 { font-size: 2rem; }
code { background: #f3f4f6; padding: 0.12rem 0.25rem; border-radius: 4px; }
pre { background: #0f172a; color: #e5e7eb; overflow-x: auto; padding: 16px; border-radius: 6px; }
pre code { background: transparent; padding: 0; }
a { color: #0969da; }
.hero { border-bottom: 1px solid #e5e7eb; padding-bottom: 20px; margin-bottom: 24px; }
</style>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "GitHub skill-group quickstart for agent-skill-groups",
"description": "Run a reversible local Agent Skills current-session loading and profile workflow with agent-skill-groups.",
"url": "https://go165.github.io/agent-skill-groups/quickstart.html",
"tool": [
{
"@type": "HowToTool",
"name": "Python 3.10+"
},
{
"@type": "HowToTool",
"name": "agent-skill-groups"
}
],
"step": [
{
"@type": "HowToStep",
"name": "Install the CLI",
"text": "Install agent-skill-groups from the v0.3.52 GitHub release wheel or from the GitHub repository."
},
{
"@type": "HowToStep",
"name": "Create a clean sample skill repository",
"text": "Create one active skill and one disabled skill with SKILL.md metadata."
},
{
"@type": "HowToStep",
"name": "Run the reversible workflow",
"text": "Run init, backup, plan, session-load, session-unload, memory --write, profile, and restore."
}
]
}
</script>
</head>
<body>
<main>
<section class="hero">
<h1>GitHub skill-group quickstart</h1>
<p><strong>A copy-paste demo for the GitHub agent-skill-group manager.</strong></p>
<p>This page shows a small reversible workflow for <a href="https://github.com/go165/agent-skill-groups">agent-skill-groups</a>, a runtime-aware manager for local Agent Skills and <code>SKILL.md</code> repositories.</p>
</section>
<h2>Install</h2>
<p>Install from the latest verified GitHub release wheel:</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 runtimes</code></pre>
<h2>Run The One-Command Demo</h2>
<p>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.</p>
<pre><code>agent-skill-groups demo --json</code></pre>
<h2>Run The Manual Clean Demo</h2>
<p>The demo creates two local skills, generates a group table, renders current-session load and unload packs, writes an agent memory block, moves one skill into the active root, and restores the original state.</p>
<pre><code>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 session-load \
--config "$tmp/groups.json" \
figma-design
agent-skill-groups session-unload \
--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"</code></pre>
<h2>What This Proves</h2>
<ul>
<li><code>init</code> can create a usable <code>groups.json</code> from real <code>SKILL.md</code> directories.</li>
<li><code>plan</code> shows the filesystem change before it happens.</li>
<li><code>session-load</code> renders a current-conversation context pack without moving directories.</li>
<li><code>session-unload</code> renders a current-conversation stop pack without moving directories.</li>
<li><code>memory --write</code> creates a managed <code>AGENTS.md</code> instruction block for future agent sessions.</li>
<li><code>profile</code> moves only the selected scenario skill into the active root.</li>
<li><code>restore</code> returns the skill repository to its prior state.</li>
</ul>
<h2>More</h2>
<p>Read the <a href="REAL_WORLD_TEST.md">real-world test plan</a>, <a href="INSTALL.md">install guide</a>, or the <a href="https://github.com/go165/agent-skill-groups/releases/tag/v0.3.52">v0.3.52 release</a>.</p>
<p>Search aliases: <a href="https://go165.github.io/github-skill-group/">GitHub skill-group</a> and <a href="https://go165.github.io/github-agent-skill-group/">GitHub agent-skill-group</a>.</p>
</main>
</body>
</html>