docs: clarify OpenCode V1 and V2 skill behavior

docs/README.opencode.md

@@ -94,7 +94,10 @@ description: Use when [condition] - [what it does]
 
 Create project-specific skills in `.opencode/skills/` within your project.
 
-**Skill Priority:** Project skills > Personal skills > Superpowers skills
+**V2 Skill Priority:** Project skills > Personal skills > Superpowers skills. On
+tested V1 1.18.31, bundled Superpowers skills take precedence when a personal
+or project skill has the same name; use distinct names for personal and project
+skills. This behavior is unchanged by the migration.
 
 ## Updating
 

index.js

@@ -1,8 +1,8 @@
 // Root entrypoint for OpenCode v2 directory-form plugin registration.
 //
-// v2 hosts (>= beta-18743) require config plugin entries to be directories
+// OpenCode V2 hosts (2.0.4 or later) require config plugin entries to be directories
 // with an index entrypoint (`index.js`) and reject bare file paths
 // ("configured plugin path must be a directory"). npm/git package installs
 // resolve via package.json `main`; this file only serves the directory form
-// (e.g. `"plugin": ["~/superpowers"]` or a `node_modules/superpowers` path).
+// (e.g. `"plugins": ["~/superpowers"]` or a `node_modules/superpowers` path).
 export { default } from "./.opencode/plugins/superpowers.js";