[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78ARCSX2EADA3KJSH49Z6ZK":3,"skill-same:01M78ARCSX2EADA3KJSH49Z6ZK":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":14,"repositoryHtmlUrl":44,"repositoryHomepageUrl":6,"ownerHtmlUrl":45,"ownerBlogUrl":6,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M78ARCSX2EADA3KJSH49Z6ZK","remote-mcp-oauth-setup",null,"Use when adding OAuth-gated remote MCP servers to Hermes.","abdullibrahim733-pixel\u002FEagle","abdullibrahim733-pixel","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F230504522?v=4","01M787SK0DQR0H1K326DJT6EBK","ibrahim abdull","01M787SK1HWS9V959THKZM6N70",0,"MIT","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fautonomous-ai-agents\u002Fremote-mcp-oauth-setup\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: remote-mcp-oauth-setup\ndescription: \"Use when adding OAuth-gated remote MCP servers to Hermes.\"\nversion: 1.0.0\nauthor: Hermes Agent\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  hermes:\n    tags: [hermes, mcp, oauth, remote-server, setup, configuration]\n    related_skills: [hermes-agent]\n---\n\n# Remote MCP Server Setup (OAuth)\n\nConnecting Hermes to REMOTE (Streamable HTTP) MCP servers gated behind OAuth 2.1 — e.g.\nSVGator (`https:\u002F\u002Fmcp.svgator.com\u002Fmcp`, 22 tools), Linear, Betterstack, or any\n`https:\u002F\u002F...\u002Fmcp` endpoint using dynamic client registration + PKCE.\n\nLoad the `hermes-agent` skill's `references\u002Fnative-mcp.md` for the config schema; THIS skill\ncovers the operational flow and the failure modes that doc doesn't.\n\n## Trigger\n\n- User asks to \"set up \u002F connect \u002F clone-and-configure\" an MCP server whose repo or docs\n  point at a remote `https:\u002F\u002F...\u002Fmcp` endpoint.\n- Often the repo is DOCS-ONLY + a `server.json` manifest with a `remotes[].url` — clone it\n  for reference, but there is nothing to build or install locally.\n\n## Workflow\n\n1. **Identify server type first.** `server.json` with `remotes[].url` ⇒ remote server: no\n   build step. Keep the clone for its tools.md\u002Fediting.md docs.\n2. **Health-check before auth** (server reachable; unauthenticated 401 is EXPECTED):\n   ```bash\n   curl -s https:\u002F\u002FHOST\u002F.well-known\u002Foauth-authorization-server   # endpoints, S256 support\n   curl -s -o \u002Fdev\u002Fnull -w \"%{http_code}\\n\" -X POST https:\u002F\u002FHOST\u002Fmcp \\\n     -H \"Content-Type: application\u002Fjson\" \\\n     -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-06-18\",\"capabilities\":{},\"clientInfo\":{\"name\":\"probe\",\"version\":\"1\"}}}'\n   ```\n3. **Add the server — MUST run in a PTY.** Non-interactive runs fail with\n   `non-interactive environment and no cached tokens found` and the config is NOT saved\n   (the \"Save config anyway?\" prompt defaults to no). Use:\n   `terminal(command=\"hermes mcp add \u003Cname> --url \u003Curl> --auth oauth\", background=true, pty=true)`\n4. **The flow:** CLI does dynamic client registration (PKCE S256), prints an authorize URL,\n   auto-opens the browser, and blocks at a paste prompt:\n   `Or paste the redirect URL here (or the ?code=...&state=... portion) and press Enter.`\n5. **User authorizes in their REAL browser** (see pitfall 1). The redirect must reach the\n   CLI's localhost callback (`127.0.0.1:\u003Cport>\u002Fcallback`); the CLI exchanges the code for\n   tokens, lists tools, asks enable-all, and saves config.\n6. **Verify:**\n   - `hermes mcp list` shows the server; `config.yaml` has `mcp_servers.\u003Cname> {url, auth: oauth}`\n   - Token file exists: `~\u002F.hermes\u002Fmcp-tokens\u002F\u003Cname>.json` (0600) alongside\n     `\u003Cname>.client.json` (client registration) and `\u003Cname>.meta.json` (server metadata)\n   - `hermes mcp test \u003Cname>` connects and lists tools\n\n## Pitfalls\n\n1. **NEVER open the OAuth authorize URL in the Hermes preview pane** (`open_preview`). The\n   preview pane is a rendering surface, not a browser session with a route back to the CLI's\n   localhost listener: it consumes the one-time authorization code, the redirect to\n   `127.0.0.1:\u003Cport>\u002Fcallback` dies, the CLI prints `✗ Failed to connect:` with an EMPTY\n   error, and the code is burned. Let the CLI's auto-opened real browser complete the flow.\n2. **Recovering a burned callback:** re-run `hermes mcp add \u003Cname> --url \u003Curl> --auth oauth`\n   in a fresh PTY — the client registration (`mcp-tokens\u002F\u003Cname>.client.json`) persists and is\n   reused. Have the user authorize in the real browser this time.\n3. **Manual paste completion** (browser can't reach localhost, e.g. sandboxed): ask the user\n   to copy the full `http:\u002F\u002F127.0.0.1:\u003Cport>\u002Fcallback?code=...&state=...` from the address\n   bar, then `process(action='submit', data=\u003Curl>)` into the waiting PTY. Confirm `state=`\n   matches the URL the CLI printed before exchanging.\n4. **The paste prompt rejects non-callback input** (`Pasted input did not contain code= or\n   error= — ignoring.`). Answer any earlier prompt (`[y\u002FN]`) with `submit` BEFORE the paste\n   prompt appears, or type `skip` to bail. Submitting stray text to the paste prompt does\n   nothing useful and loops.\n5. **Access tokens are short-lived (~1h)** with refresh-token rotation. If a connection\n   dies later, `hermes mcp reauth \u003Cname>` (or `hermes mcp login \u003Cname>`) re-runs the flow.\n6. **Diagnosis script** shipped in the Hermes source classifies connection state without\n   printing secrets:\n   `~\u002F.hermes\u002Fhermes-agent\u002Foptional-skills\u002Fmcp\u002Fmcp-oauth-remote-gateway\u002Fscripts\u002Fdiagnose-oauth-mcp.py \u003Cname>`\n   → branches TOKEN_OK \u002F REFRESH_FIXED \u002F SESSION_REVOKED \u002F REFRESH_DEAD.\n7. Provider holds tokens server-side; the model only ever sees tool results. Never log or\n   paste access tokens. Hermes env-filters stdio subprocesses, so secrets must be passed via\n   the `env:` config key.\n","# Remote MCP Server Setup (OAuth)\n\nConnecting Hermes to REMOTE (Streamable HTTP) MCP servers gated behind OAuth 2.1 — e.g.\nSVGator (`https:\u002F\u002Fmcp.svgator.com\u002Fmcp`, 22 tools), Linear, Betterstack, or any\n`https:\u002F\u002F...\u002Fmcp` endpoint using dynamic client registration + PKCE.\n\nLoad the `hermes-agent` skill's `references\u002Fnative-mcp.md` for the config schema; THIS skill\ncovers the operational flow and the failure modes that doc doesn't.\n\n## Trigger\n\n- User asks to \"set up \u002F connect \u002F clone-and-configure\" an MCP server whose repo or docs\n  point at a remote `https:\u002F\u002F...\u002Fmcp` endpoint.\n- Often the repo is DOCS-ONLY + a `server.json` manifest with a `remotes[].url` — clone it\n  for reference, but there is nothing to build or install locally.\n\n## Workflow\n\n1. **Identify server type first.** `server.json` with `remotes[].url` ⇒ remote server: no\n   build step. Keep the clone for its tools.md\u002Fediting.md docs.\n2. **Health-check before auth** (server reachable; unauthenticated 401 is EXPECTED):\n   ```bash\n   curl -s https:\u002F\u002FHOST\u002F.well-known\u002Foauth-authorization-server   # endpoints, S256 support\n   curl -s -o \u002Fdev\u002Fnull -w \"%{http_code}\\n\" -X POST https:\u002F\u002FHOST\u002Fmcp \\\n     -H \"Content-Type: application\u002Fjson\" \\\n     -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-06-18\",\"capabilities\":{},\"clientInfo\":{\"name\":\"probe\",\"version\":\"1\"}}}'\n   ```\n3. **Add the server — MUST run in a PTY.** Non-interactive runs fail with\n   `non-interactive environment and no cached tokens found` and the config is NOT saved\n   (the \"Save config anyway?\" prompt defaults to no). Use:\n   `terminal(command=\"hermes mcp add \u003Cname> --url \u003Curl> --auth oauth\", background=true, pty=true)`\n4. **The flow:** CLI does dynamic client registration (PKCE S256), prints an authorize URL,\n   auto-opens the browser, and blocks at a paste prompt:\n   `Or paste the redirect URL here (or the ?code=...&state=... portion) and press Enter.`\n5. **User authorizes in their REAL browser** (see pitfall 1). The redirect must reach the\n   CLI's localhost callback (`127.0.0.1:\u003Cport>\u002Fcallback`); the CLI exchanges the code for\n   tokens, lists tools, asks enable-all, and saves config.\n6. **Verify:**\n   - `hermes mcp list` shows the server; `config.yaml` has `mcp_servers.\u003Cname> {url, auth: oauth}`\n   - Token file exists: `~\u002F.hermes\u002Fmcp-tokens\u002F\u003Cname>.json` (0600) alongside\n     `\u003Cname>.client.json` (client registration) and `\u003Cname>.meta.json` (server metadata)\n   - `hermes mcp test \u003Cname>` connects and lists tools\n\n## Pitfalls\n\n1. **NEVER open the OAuth authorize URL in the Hermes preview pane** (`open_preview`). The\n   preview pane is a rendering surface, not a browser session with a route back to the CLI's\n   localhost listener: it consumes the one-time authorization code, the redirect to\n   `127.0.0.1:\u003Cport>\u002Fcallback` dies, the CLI prints `✗ Failed to connect:` with an EMPTY\n   error, and the code is burned. Let the CLI's auto-opened real browser complete the flow.\n2. **Recovering a burned callback:** re-run `hermes mcp add \u003Cname> --url \u003Curl> --auth oauth`\n   in a fresh PTY — the client registration (`mcp-tokens\u002F\u003Cname>.client.json`) persists and is\n   reused. Have the user authorize in the real browser this time.\n3. **Manual paste completion** (browser can't reach localhost, e.g. sandboxed): ask the user\n   to copy the full `http:\u002F\u002F127.0.0.1:\u003Cport>\u002Fcallback?code=...&state=...` from the address\n   bar, then `process(action='submit', data=\u003Curl>)` into the waiting PTY. Confirm `state=`\n   matches the URL the CLI printed before exchanging.\n4. **The paste prompt rejects non-callback input** (`Pasted input did not contain code= or\n   error= — ignoring.`). Answer any earlier prompt (`[y\u002FN]`) with `submit` BEFORE the paste\n   prompt appears, or type `skip` to bail. Submitting stray text to the paste prompt does\n   nothing useful and loops.\n5. **Access tokens are short-lived (~1h)** with refresh-token rotation. If a connection\n   dies later, `hermes mcp reauth \u003Cname>` (or `hermes mcp login \u003Cname>`) re-runs the flow.\n6. **Diagnosis script** shipped in the Hermes source classifies connection state without\n   printing secrets:\n   `~\u002F.hermes\u002Fhermes-agent\u002Foptional-skills\u002Fmcp\u002Fmcp-oauth-remote-gateway\u002Fscripts\u002Fdiagnose-oauth-mcp.py \u003Cname>`\n   → branches TOKEN_OK \u002F REFRESH_FIXED \u002F SESSION_REVOKED \u002F REFRESH_DEAD.\n7. Provider holds tokens server-side; the model only ever sees tool results. Never log or\n   paste access tokens. Hermes env-filters stdio subprocesses, so secrets must be passed via\n   the `env:` config key.\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":37,"description":7},"Hermes Agent","1.0.0",{"hermes":27},{"tags":28,"related_skills":35},[29,30,31,32,33,34],"hermes","mcp","oauth","remote-server","setup","configuration",[36],"hermes-agent",[38,39,40],"linux","macos","windows","main","1f420fcb3f20524e8a830b9d010e0c0ee312d437","hermes-backup\u002Fskills\u002Fautonomous-ai-agents\u002Fremote-mcp-oauth-setup","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel","I am a developer at UMG Africa and i have 2 years of software development also i engage with embedded softwares i am good in rust, cpp, python and kotlin","2026-08-16 18:04:02",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add abdullibrahim733-pixel\u002FEagle --skill remote-mcp-oauth-setup",{"tool":54,"command":55},"bunx","bunx skills add abdullibrahim733-pixel\u002FEagle --skill remote-mcp-oauth-setup",{"tool":57,"command":58},"pnpm","pnpm dlx skills add abdullibrahim733-pixel\u002FEagle --skill remote-mcp-oauth-setup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fautonomous-ai-agents\u002Fremote-mcp-oauth-setup\u002FSKILL.md",true,[],[63,70,77,84,91,98],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M78BBHAQCSZNG7HYMB97YG3Y","web-ui-verification","Verify web UIs via headless Chrome CDP, no vision needed.","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Fweb-ui-verification\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M78BB60RHXBY2QV4TA9S917B","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M78BB16QRJZA9P3TXN5SHCQH","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Fsystematic-debugging\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M78BAY69B9JP3SK2NAF3EH2D","spike","Throwaway experiments to validate an idea before build.","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Fspike\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M78BAVDMEBYN49PRDQ8QXTBJ","simplify-code","Parallel 4-agent cleanup of recent code changes.","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Fsimplify-code\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M78BAE09PQ5RV5MSJN1S788A","scroll-driven-3d-websites","Scroll-scrubbed 3D promo sites (Three.js + GSAP).","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Fscroll-driven-3d-websites\u002FSKILL.md",[],[]]