ngrok-setup
Get authenticated and ready to use ngrok on whatever surface the task needs - agent CLI, an SDK, or infrastructure-as-code. Detects what is already installed, walks the one-time authtoken step, and routes to the right surface. Use before other ngrok tasks, or whenever an ngrok command fails with an authentication or configuration error. Use when the user says "set up ngrok", "install ngrok", "add my authtoken", "ngrok isn't authenticated", or "getting an auth error from ngrok".
Install
With your agent
Install OMGSkills skill "ngrok/skills:skills/ngrok-setup" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/ngrok/skills /tmp/skills && ln -s /tmp/skills/skills/ngrok-setup ~/.claude/skills/ngrok-setupFrom README
Set up ngrok Get the user authenticated and pointed at the right surface. Every ngrok action requires an authtoken (agent/SDK) or an API key (IaC) - there is no unauthenticated mode; this is deliberate abuse prevention. Figure out the surface Pick from what the user is doing, then defer the how-to to that surface skill: ngrok-surfaces carries the routing table and the per-surface mechanics - read it off the user's project rather than asking. In short: a terminal means the agent CLI, an ngrok dependency in a manifest means the SDK, .tf or k8s manifests mean infrastructure-as-code, and a controlplane provisioning per-tenant resources means the REST API. If it is not obvious, the terminal path is the safe default for one-off tasks. Authenticate CLI / SDK (authtoken): Check for an existing token: ngrok config check, and check the NGROKAUTHTOKEN env var. If none is set, have the user set it themselves - do not ask them to paste the token to you.
More from this repo
expose-localhost
Expose a local service to the public internet using ngrok.
ngrok-engine
Reference for ngrok's traffic model - what an endpoint is and what happens to traffic at the edge.
ngrok-surfaces
How to apply an ngrok endpoint and Traffic Policy on whichever surface the user is actually working in - the agent CLI...