docs(website): dedicated page per bundled + optional skill (#14929)

Generates a full dedicated Docusaurus page for every one of the 132 skills
(73 bundled + 59 optional) under website/docs/user-guide/skills/{bundled,optional}/<category>/.
Each page carries the skill's description, metadata (version, author, license,
dependencies, platform gating, tags, related skills cross-linked to their own
pages), and the complete SKILL.md body that Hermes loads at runtime.

Previously the two catalog pages just listed skills with a one-line blurb and
no way to see what the skill actually did — users had to go read the source
repo. Now every skill has a browsable, searchable, cross-linked reference in
the docs.

- website/scripts/generate-skill-docs.py — generator that reads skills/ and
  optional-skills/, writes per-skill pages, regenerates both catalog indexes,
  and rewrites the Skills section of sidebars.ts. Handles MDX escaping
  (outside fenced code blocks: curly braces, unsafe HTML-ish tags) and
  rewrites relative references/*.md links to point at the GitHub source.
- website/docs/reference/skills-catalog.md — regenerated; each row links to
  the new dedicated page.
- website/docs/reference/optional-skills-catalog.md — same.
- website/sidebars.ts — Skills section now has Bundled / Optional subtrees
  with one nested category per skill folder.
- .github/workflows/{docs-site-checks,deploy-site}.yml — run the generator
  before docusaurus build so CI stays in sync with the source SKILL.md files.

Build verified locally with `npx docusaurus build`. Only remaining warnings
are pre-existing broken link/anchor issues in unrelated pages.

website/docs/user-guide/skills/optional/mcp/mcp-mcporter.md

@@ -0,0 +1,137 @@
+---
+title: "Mcporter"
+sidebar_label: "Mcporter"
+description: "Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type gene..."
+---
+
+{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
+
+# Mcporter
+
+Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
+
+## Skill metadata
+
+| | |
+|---|---|
+| Source | Optional — install with `hermes skills install official/mcp/mcporter` |
+| Path | `optional-skills/mcp/mcporter` |
+| Version | `1.0.0` |
+| Author | community |
+| License | MIT |
+| Tags | `MCP`, `Tools`, `API`, `Integrations`, `Interop` |
+
+## Reference: full SKILL.md
+
+:::info
+The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
+:::
+
+# mcporter
+
+Use `mcporter` to discover, call, and manage [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) servers and tools directly from the terminal.
+
+## Prerequisites
+
+Requires Node.js:
+```bash
+# No install needed (runs via npx)
+npx mcporter list
+
+# Or install globally
+npm install -g mcporter
+```
+
+## Quick Start
+
+```bash
+# List MCP servers already configured on this machine
+mcporter list
+
+# List tools for a specific server with schema details
+mcporter list <server> --schema
+
+# Call a tool
+mcporter call <server.tool> key=value
+```
+
+## Discovering MCP Servers
+
+mcporter auto-discovers servers configured by other MCP clients (Claude Desktop, Cursor, etc.) on the machine. To find new servers to use, browse registries like [mcpfinder.dev](https://mcpfinder.dev) or [mcp.so](https://mcp.so), then connect ad-hoc:
+
+```bash
+# Connect to any MCP server by URL (no config needed)
+mcporter list --http-url https://some-mcp-server.com --name my_server
+
+# Or run a stdio server on the fly
+mcporter list --stdio "npx -y @modelcontextprotocol/server-filesystem" --name fs
+```
+
+## Calling Tools
+
+```bash
+# Key=value syntax
+mcporter call linear.list_issues team=ENG limit:5
+
+# Function syntax
+mcporter call "linear.create_issue(title: \"Bug fix needed\")"
+
+# Ad-hoc HTTP server (no config needed)
+mcporter call https://api.example.com/mcp.fetch url=https://example.com
+
+# Ad-hoc stdio server
+mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com
+
+# JSON payload
+mcporter call <server.tool> --args '{"limit": 5}'
+
+# Machine-readable output (recommended for Hermes)
+mcporter call <server.tool> key=value --output json
+```
+
+## Auth and Config
+
+```bash
+# OAuth login for a server
+mcporter auth <server | url> [--reset]
+
+# Manage config
+mcporter config list
+mcporter config get <key>
+mcporter config add <server>
+mcporter config remove <server>
+mcporter config import <path>
+```
+
+Config file location: `./config/mcporter.json` (override with `--config`).
+
+## Daemon
+
+For persistent server connections:
+```bash
+mcporter daemon start
+mcporter daemon status
+mcporter daemon stop
+mcporter daemon restart
+```
+
+## Code Generation
+
+```bash
+# Generate a CLI wrapper for an MCP server
+mcporter generate-cli --server <name>
+mcporter generate-cli --command <url>
+
+# Inspect a generated CLI
+mcporter inspect-cli <path> [--json]
+
+# Generate TypeScript types/client
+mcporter emit-ts <server> --mode client
+mcporter emit-ts <server> --mode types
+```
+
+## Notes
+
+- Use `--output json` for structured output that's easier to parse
+- Ad-hoc servers (HTTP URL or `--stdio` command) work without any config — useful for one-off calls
+- OAuth auth may require interactive browser flow — use `terminal(command="mcporter auth <server>", pty=true)` if needed