automaintainer: Improve supercli static documentation: README, CONTRIBUTING… (#187)

* docs: clarify CONTRIBUTING prerequisites and plugin dev section

Add bun to prerequisites (used by description enhancement pipeline scripts)
with note that it is optional. Expand plugin development section with the
isolated file convention directory tree and explicit warning not to edit
shared files — new contributors frequently miss this constraint.

* docs: replace confusing install example in README with practical workflow

The Node.js install section showed 'npx supercli uuid self generate' which
is a UUID utility command, not a useful first-run experience. Replace with
'skills list' which immediately demonstrates supercli's core value: querying
the 5000+ plugin catalog.

* docs: add server-plugins-usage-guide to features index

The server-plugins-usage-guide.md file exists in docs/ but was not linked
from the features index, making it undiscoverable for users browsing the
feature documentation. Add it to the feature index table.

---------

Co-authored-by: SuperCLI Dev <dev@supercli.dev>

Author: javimosch

CONTRIBUTING.md

@@ -21,6 +21,7 @@ Before contributing, ensure you have:
 - [Node.js](https://nodejs.org/) (LTS version recommended)
 - [npm](https://www.npmjs.com/) or [pnpm](https://pnpm.io/)
 - Git for version control
+- [bun](https://bun.sh/) (optional, only needed for description enhancement pipeline scripts)
 - Any CLI tools you want to create plugins for
 
 ### Setting Up Your Development Environment
@@ -232,7 +233,16 @@ When creating or updating plugins:
 
 ### Want to Create a New Plugin?
 
-New bundled plugins use an **isolated file convention** — no shared file edits needed.
+New bundled plugins use an **isolated file convention** — create files ONLY inside `plugins/<name>/`. Never edit `plugins/plugins.json` or `cli/plugin-install-guidance.js` for new plugins.
+
+```
+plugins/my-plugin/
+├── plugin.json              # Required: manifest with commands
+├── meta.json                # Required: description, tags, has_learn
+├── install-guidance.json    # Optional: install steps
+├── skills/quickstart/SKILL.md  # Optional: agent guide
+└── README.md                # Optional: human docs
+```
 
 See our detailed [Plugin Harness Development Guide](docs/plugins-how-to.md) for:
 

README.md

@@ -329,8 +329,8 @@ curl -sSL https://github.com/javimosch/supercli/releases/download/v0.1.0-zig/ins
 ### Option 2: Node.js Version (npx/npm)
 
 ```bash
-# Run immediately
-npx supercli uuid self generate
+# Run immediately — no install needed
+npx supercli skills list
 
 # Install globally
 npm install -g superacli

docs/features/README.md

@@ -17,6 +17,7 @@ Detailed documentation for supercli's core features and capabilities.
 | [Config Sync](config-sync.md) | Configuration synchronization between client and server | [Read →](config-sync.md) |
 | [Execution Plans](execution-plans.md) | Planning and execution of command sequences | [Read →](execution-plans.md) |
 | [Azure DevOps & UiPath Plugins](azd-uipath-plugins.md) | Azure Developer CLI and UiPath automation harnesses | [Read →](azd-uipath-plugins.md) |
+| [Server Plugins Usage Guide](../server-plugins-usage-guide.md) | Manual testing of server plugins including JSON and ZIP flows | [Read →](../server-plugins-usage-guide.md) |
 
 ## Quick Navigation