ngrok Agent Skills
Официальный набор скиллов ngrok: публичный адрес для локального сервиса, защита входа, вебхуки и разбор ошибок.
- 16 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Туннель открывает локальный сервис в интернет, и до включения защиты входа адрес доступен всем, кто его знает.
- Агент запускает ngrok CLI и пишет конфигурацию с правилами Traffic Policy.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/ngrok-agent-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Туннель открывает локальный сервис в интернет, и до включения защиты входа адрес доступен всем, кто его знает.
- Агент запускает ngrok CLI и пишет конфигурацию с правилами Traffic Policy.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Набор из семи прикладных скиллов ngrok. Агент открывает туннель к локальному сервису по HTTP или TCP (SSH, RDP, базы данных), ставит на адрес вход через OAuth, лимиты запросов и правила по IP, принимает вебхуки Stripe, GitHub и еще более 70 провайдеров с проверкой подписи на стороне ngrok. Остальные скиллы публикуют MCP-сервер в разработке, выдают отдельную конечную точку каждой песочнице или клиенту, разбирают ошибки вроде ERR_NGROK_3200 и проводят первичную настройку. Два справочных скилла, ngrok-engine и ngrok-surfaces, подгружаются сами: правила Traffic Policy с 26 действиями и способы применять настройки через CLI, SDK, REST API, Terraform и Kubernetes Operator.
Для кого. Разработчикам, которым нужно показать локальное приложение коллеге или принять вебхук на ноутбуке, и командам, что строят на ngrok песочницы для агентов.
Подходит, если
- Stripe или GitHub должны достучаться до сервиса на ноутбуке, у которого нет публичного адреса.
- Черновик сайта показывают заказчику по ссылке, закрытой входом через Google.
- К машине без публичного IP подключаются по SSH или RDP через TCP-туннель.
- Локальный MCP-сервер подключают к Claude или другому провайдеру со своим ключом доступа.
Не подходит, если
- У сервиса уже есть постоянный публичный адрес и обратный прокси: туннель ничего не добавит.
- ngrok CLI не установлен и аккаунта нет: скиллы работают поверх CLI с токеном.
- Данные нельзя выводить в интернет даже под защитой входа: публичный адрес остается точкой входа.
Пример запроса к агенту
Открой мое приложение на порту 3000 по публичной ссылке и пусти на нее только адреса @mycompany.com через вход Google.Ограничения
Скиллы работают поверх установленного и авторизованного ngrok CLI с токеном из личного кабинета. У нового аккаунта может не быть бесплатного dev-домена: его создают на странице доменов в дашборде, иначе туннель вернет ERR_NGROK_15013. Команда `npx skills add ngrok/skills` ставит весь набор через утилиту skills и опирается на файл SKILL.md каждого скилла. Условия тарифов ngrok для вебхуков и правил Traffic Policy в репозитории не описаны.
Как отключить. Отключите плагин через команду `/plugin` в Claude Code или удалите папки скиллов из каталога навыков агента. Запущенный туннель остановите в терминале, токен отзовите в дашборде ngrok.
Частые вопросы
Как поставить скиллы ngrok в Claude Code?
Выполните `/plugin marketplace add ngrok/skills`, затем `/plugin install ngrok@ngrok`. Появятся команды вида `/ngrok:expose-localhost`. Тот же набор ставит `npx skills add ngrok/skills` для любого агента с поддержкой формата Agent Skills.
Нужен ли аккаунт ngrok?
Да. Скиллы вызывают ngrok CLI, а ему нужен токен: возьмите его в дашборде и добавьте командой `ngrok config add-authtoken`. Без токена агент остановится на предварительной проверке и попросит его.
Какие агенты поддерживаются?
Claude Code, Cursor, ChatGPT и Codex через плагин, остальные через `npx skills add`. В Cursor маркетплейс добавляют из репозитория ngrok/skills, в Codex командой `codex plugin marketplace add ngrok/skills`.
Что делать, если туннель не поднимается?
Попросите агента применить скилл troubleshoot-ngrok. Он разбирает коды вроде ERR_NGROK_3200 и случай, когда на localhost страница работает, а через адрес ngrok приходит 400.
Что умеет скилл receive-webhooks?
Он принимает вебхуки Stripe, GitHub и еще более 70 провайдеров на один адрес и проверяет подпись на стороне ngrok. Сервис за NAT получает события без открытого порта.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыОфициальный набор скиллов Cloudflare для агентов: Workers, Durable Objects, wrangler, Pages, хранилища и MCP-сервер
Туннель для localhost с собственным реле: публичный HTTPS-адрес для локального сервиса без аккаунта, плюс скиллы для агентов
Agent Skills для продуктов Google
Agent Skills for Google products and technologies
Официальная коллекция скиллов Google для работы с Google Cloud, BigQuery, GKE, рекламой и аналитикой из агента
Скилл KubeShark: агент сначала ищет режим отказа, потом пишет манифесты, Helm и Kustomize по официальным практикам и возвращает план проверки и отката
Скиллы Microsoft Learn почти по каждому сервису Azure: лимиты, настройка, безопасность, архитектура и диагностика со ссылками на документацию
Скилл и бинарник на Go: агент с вашего согласия ставит на ваш сервер приложения из каталога в 93 программы через Docker Compose
Коротко о README
Набор ставится как плагин для Claude Code, Cursor, ChatGPT и Codex или как обычные скиллы утилитой skills. Таблица связывает каждый из семи скиллов с задачей и примерами фраз, два справочных скилла описаны отдельно. Лицензия MIT.
Бейдж для README
Исходный SKILL.md
--- name: expose-localhost description: Expose a local service to the public internet using ngrok. Starts a tunnel, optionally adds OAuth or WAF via Traffic Policy. Handles HTTP services and raw TCP (SSH, RDP, databases). Use when asked to expose, tunnel, share, or make a local service publicly accessible, or to reach a machine that has no public IP. Also covers sharing work-in-progress with a specific person and the dev-server quirks that break a shared preview. license: MIT metadata: author: ngrok version: "2.1" compatibility: Requires ngrok CLI installed and authenticated. --- # Expose Localhost Expose a local service to the public internet using ngrok. Optionally add OAuth, OWASP protection, or rate limiting via Traffic Policy. ## Prerequisites - ngrok CLI installed (`ngrok` command available) - Auth token configured (`ngrok config add-authtoken <TOKEN>`) ## Workflow ### Step 1: Pre-flight & Configuration Silently verify ngrok is ready: ```bash ngrok config check ``` If auth token missing, tell user to run: `ngrok config add-authtoken <TOKEN>` (get token at https://dashboard.ngrok.com/get-started/your-authtoken) Then **ask all questions upfront** before doing anything: ``` Before I expose your service, I need a few details: 1. **Port**: I see your app runs on port 3000. Is that correct? 2. **Domain**: Use your dev domain, or do you have a custom domain? 3. **Access control**: Open access, or require login (Google/GitHub/etc.)? 4. **Save config?**: One-time setup, or save for reuse? ``` Do NOT mention cloud endpoints, reserved domains, or internal endpoints — those are advanced concepts the user shouldn't need to think about. **Detecting the port**: Check `package.json` scripts for `--port`, `.env` for `PORT=`, `docker-compose.yml` for port mappings.