<feed xmlns='http://www.w3.org/2005/Atom'>
<title>superpowers.git/docs/README.opencode.md, branch fix/2583-opencode-skill-names</title>
<subtitle>Agentic skills framework and development workflow
</subtitle>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/'/>
<entry>
<title>fix(opencode): tell the model skill ids are bare names (#2583)</title>
<updated>2026-10-22T21:04:25+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-10-22T21:04:25+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=8f4b3dbd2f5ef8163e4daed5ca43a4cf08eb5d8c'/>
<id>8f4b3dbd2f5ef8163e4daed5ca43a4cf08eb5d8c</id>
<content type='text'>
Skills name each other with the Claude Code plugin namespace
(`superpowers:brainstorming`), and the using-superpowers bootstrap that
the OpenCode plugin injects says "Let's build X -&gt; superpowers:brainstorming
first". OpenCode registers superpowers skills under bare ids
(`brainstorming`) on both flavors and its `skill` tool does an exact
lookup, so a model that copies the namespaced form gets
"Unable to load skill superpowers:brainstorming" (V2) or
`Skill "superpowers:brainstorming" not found` (V1) and carries on
without the skill. The OpenCode tool mapping said only "Invoke a skill
-&gt; OpenCode's native skill tool" and never stated the id convention.

Reproduced on real hosts (OpenCode 2.1.2 and opencode-ai 1.19.4) with a
scripted stub provider: the namespaced call fails, the bare id loads.

Add the convention to the "Invoke a skill" line of both mappings, with
each flavor's real skill parameter (V1 `name`, V2 `id`), and mirror it
in docs/README.opencode.md. Skill prose keeps the prefix, which is
correct on Claude Code; the translation belongs in the harness mapping,
the same way the Hermes reference shows bare `skill_view("brainstorming")`.

Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Skills name each other with the Claude Code plugin namespace
(`superpowers:brainstorming`), and the using-superpowers bootstrap that
the OpenCode plugin injects says "Let's build X -&gt; superpowers:brainstorming
first". OpenCode registers superpowers skills under bare ids
(`brainstorming`) on both flavors and its `skill` tool does an exact
lookup, so a model that copies the namespaced form gets
"Unable to load skill superpowers:brainstorming" (V2) or
`Skill "superpowers:brainstorming" not found` (V1) and carries on
without the skill. The OpenCode tool mapping said only "Invoke a skill
-&gt; OpenCode's native skill tool" and never stated the id convention.

Reproduced on real hosts (OpenCode 2.1.2 and opencode-ai 1.19.4) with a
scripted stub provider: the namespaced call fails, the bare id loads.

Add the convention to the "Invoke a skill" line of both mappings, with
each flavor's real skill parameter (V1 `name`, V2 `id`), and mirror it
in docs/README.opencode.md. Skill prose keeps the prefix, which is
correct on Claude Code; the translation belongs in the harness mapping,
the same way the Hermes reference shows bare `skill_view("brainstorming")`.

Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</pre>
</div>
</content>
</entry>
<entry>
<title>chore: bump version to 7.0.1</title>
<updated>2026-10-21T20:03:27+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-10-21T20:03:27+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=c4c226fe39558c2056b08a134cbf5d103bee215d'/>
<id>c4c226fe39558c2056b08a134cbf5d103bee215d</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Release prep for v7.0.0 (#2488)</title>
<updated>2026-10-09T23:55:01+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@primeradiant.com</email>
</author>
<published>2026-10-09T23:55:01+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=74bcce130ab12d5db63639179632f4d7d4e2c5f3'/>
<id>74bcce130ab12d5db63639179632f4d7d4e2c5f3</id>
<content type='text'>
- RELEASE-NOTES.md: v7.0.0 section covering everything on dev since v6.4.2,
  led by the brainstorming rebuild (#2463, #2482, #2483)
- Bump all 11 declared manifests to 7.0.0; OpenCode pin examples point at #v7.0.0
- bump-version.sh --audit matches whole version strings only, so 7.0.0 no
  longer matches inside 127.0.0.1
- test-render-graphs.sh resolves the real node binary so its empty-PATH case
  works under version-manager shims (mise, asdf)</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
- RELEASE-NOTES.md: v7.0.0 section covering everything on dev since v6.4.2,
  led by the brainstorming rebuild (#2463, #2482, #2483)
- Bump all 11 declared manifests to 7.0.0; OpenCode pin examples point at #v7.0.0
- bump-version.sh --audit matches whole version strings only, so 7.0.0 no
  longer matches inside 127.0.0.1
- test-render-graphs.sh resolves the real node binary so its empty-PATH case
  works under version-manager shims (mise, asdf)</pre>
</div>
</content>
</entry>
<entry>
<title>chore: bump version to 6.4.2</title>
<updated>2026-09-25T17:00:11+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-09-25T17:00:11+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=c68ec2840aebe836c9b8abdd4986669320891d30'/>
<id>c68ec2840aebe836c9b8abdd4986669320891d30</id>
<content type='text'>
Points the OpenCode V2 pin examples at v6.4.2.

Claude-Session: https://claude.ai/code/session_012kGFECgxu6pk4fK2L3DjXd
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Points the OpenCode V2 pin examples at v6.4.2.

Claude-Session: https://claude.ai/code/session_012kGFECgxu6pk4fK2L3DjXd
</pre>
</div>
</content>
</entry>
<entry>
<title>chore: bump version to 6.4.1</title>
<updated>2026-09-18T21:55:55+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-09-18T21:55:55+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=d6ce152d055ad642d8a66b8ba2a8a6de92180cb6'/>
<id>d6ce152d055ad642d8a66b8ba2a8a6de92180cb6</id>
<content type='text'>
v6.4.0 was never shipped; 6.4.1 is the first release with these changes.
Points the OpenCode V2 pinning docs at v6.4.1, since no v6.4.0 tag will
exist. Excludes the gitignored evals/ clone from the version audit, which
was grepping all 11G of it and never finishing.

Claude-Session: https://claude.ai/code/session_01BJAzd3A26a2XKo1JUJWySu
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
v6.4.0 was never shipped; 6.4.1 is the first release with these changes.
Points the OpenCode V2 pinning docs at v6.4.1, since no v6.4.0 tag will
exist. Excludes the gitignored evals/ clone from the version audit, which
was grepping all 11G of it and never finishing.

Claude-Session: https://claude.ai/code/session_01BJAzd3A26a2XKo1JUJWySu
</pre>
</div>
</content>
</entry>
<entry>
<title>chore: bump version to 6.4.0 (#2330)</title>
<updated>2026-09-18T18:37:41+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-09-18T18:37:41+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=1c63ca9d81353d8aeced6edd0c5778ee6154d6ae'/>
<id>1c63ca9d81353d8aeced6edd0c5778ee6154d6ae</id>
<content type='text'>
Release engineering for 6.4. </content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Release engineering for 6.4. </pre>
</div>
</content>
</entry>
<entry>
<title>docs(opencode): fix pin example, local-path examples, and V2 log troubleshooting</title>
<updated>2026-09-18T03:52:40+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@primeradiant.com</email>
</author>
<published>2026-09-18T03:52:40+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=034fae28cda8a246d80491919cc79398cb5540b8'/>
<id>034fae28cda8a246d80491919cc79398cb5540b8</id>
<content type='text'>
Restore the version-pin example for both config keys and state the V2
constraint (the pinned ref must include OpenCode V2 support). Replace the
`~/...` local-package examples with absolute paths: OpenCode does not expand
`~`, and a tilde entry is installed as a package spec rather than loaded as a
directory. Point V2 troubleshooting at `opencode run --standalone
--print-logs`, since plugin logs are server-role and hidden without
`--standalone`. Describe where the bootstrap lands when native compaction
retains user messages under the default keep budget.

Co-Authored-By: Claude Fable 5.1 &lt;noreply@anthropic.com&gt;
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Restore the version-pin example for both config keys and state the V2
constraint (the pinned ref must include OpenCode V2 support). Replace the
`~/...` local-package examples with absolute paths: OpenCode does not expand
`~`, and a tilde entry is installed as a package spec rather than loaded as a
directory. Point V2 troubleshooting at `opencode run --standalone
--print-logs`, since plugin logs are server-role and hidden without
`--standalone`. Describe where the bootstrap lands when native compaction
retains user messages under the default keep budget.

Co-Authored-By: Claude Fable 5.1 &lt;noreply@anthropic.com&gt;
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: clarify OpenCode V1 and V2 skill behavior</title>
<updated>2026-09-18T01:48:11+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@primeradiant.com</email>
</author>
<published>2026-09-18T01:48:11+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=1e0ea8fcf8b62c6a44b5b97eb183dbd98e5f2f1b'/>
<id>1e0ea8fcf8b62c6a44b5b97eb183dbd98e5f2f1b</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>docs(opencode): describe supported V2 setup and bootstrap behavior</title>
<updated>2026-09-18T01:27:50+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@primeradiant.com</email>
</author>
<published>2026-09-18T01:27:50+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=1eae439437a3fbcb892529a4a777bded256d2e2b'/>
<id>1eae439437a3fbcb892529a4a777bded256d2e2b</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>fix(opencode): align V2 tool mapping with the 2.0.3 catalog; harden plugin internals</title>
<updated>2026-09-14T09:47:03+00:00</updated>
<author>
<name>GoldJohnKing</name>
<email>GoldJohnKing@live.cn</email>
</author>
<published>2026-09-14T09:47:03+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=4996eb00bdcfad114c09610cc8b5737eb1a9f0e6'/>
<id>4996eb00bdcfad114c09610cc8b5737eb1a9f0e6</id>
<content type='text'>
- V2 bootstrap mapping now teaches write/edit/websearch (verified against
  a live v2.0.3 /api/plugin tool catalog) instead of routing all file
  mutation through patch
- frontmatter parser tolerates CRLF and YAML block scalars/continuation
  lines
- child-session cache is bounded (512 entries, oldest-quarter eviction)
- INSTALL.md and docs/README.opencode.md tool tables synced to the 2.0.3
  catalog; unit-test needle list extended to cover the new tools
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
- V2 bootstrap mapping now teaches write/edit/websearch (verified against
  a live v2.0.3 /api/plugin tool catalog) instead of routing all file
  mutation through patch
- frontmatter parser tolerates CRLF and YAML block scalars/continuation
  lines
- child-session cache is bounded (512 entries, oldest-quarter eviction)
- INSTALL.md and docs/README.opencode.md tool tables synced to the 2.0.3
  catalog; unit-test needle list extended to cover the new tools
</pre>
</div>
</content>
</entry>
</feed>
