stripe-docs

Этот официальный навык Stripe задаёт узкий терминальный workflow для чтения документации и API reference. Основная команда — stripe docs: она автоматически получает Markdown, поэтому агенту не требуется вручную собирать содержимое страниц docs.stripe.com через curl или WebFetch. Карточка полезна там, где ответ нужно строить по документации Stripe, а не по памяти: навык сначала переводит запрос в один из трёх понятных режимов — чтение страницы, поиск по документации или поиск API reference. Для чтения страницы передаётся её web path, например /payments. Такой режим подходит, когда уже известен раздел документации и нужно получить его Markdown-представление для дальнейшего анализа. Путь остаётся частью запроса: skill описывает обращение к странице по web path, а не поиск похожих материалов во внешней выдаче. Это делает сценарий воспроизводимым для конкретного раздела и не требует копировать текст документации в проект. Для тематического поиска используется stripe docs search и строка запроса, например payment intents. Результат нужен, когда пользователь знает тему, но ещё не знает точный путь страницы. Поиск выполняется внутри пространства Stripe documentation; исходный SKILL.md не обещает числовой рейтинг результатов, полнотекстовый экспорт или автоматический выбор единственной правильной страницы. Поэтому найденные страницы остаются материалом для чтения и проверки по конкретному запросу. Третий режим — stripe docs api. API reference можно искать по имени ресурса, по комбинации HTTP-метода и пути или по типу события. В исходнике приведены три формы: stripe docs api product, stripe docs api GET /v1/products и stripe docs api product.created. Это покрывает разные формулировки одной задачи: ресурс удобен для общего reference, метод с маршрутом — для конкретного endpoint, событие — для event reference. Такой выбор помогает не превращать вопрос о webhook или HTTP-маршруте в общий поиск документации. Практические сценарии карточки — открыть Markdown конкретной страницы Stripe, найти раздел по ключевому слову и получить reference по ресурсу, HTTP-маршруту или событию. Все эти операции выполняются через одну команду и различаются только подкомандой и аргументом. Разрешённый инструмент в manifest — Bash(stripe docs *), поэтому навык рассчитан на терминальную среду, где команда stripe доступна. В источнике нет требования добавлять собственную библиотеку, зеркало документов или локальный индекс. Граница применения определяется самим описанием: skill направляет к чтению и поиску Stripe documentation, а не к выполнению API-запросов, изменению ресурсов Stripe или генерации тестовых данных. Если нужен конкретный факт, сначала следует выбрать соответствующую форму запроса и получить Markdown/reference, затем использовать этот результат в ответе или следующем рабочем шаге. Карточка не заменяет проверку актуальности самой страницы и не добавляет утверждений, которых нет в полученной документации; её ценность — в коротком, повторяемом маршруте доступа к официальному источнику Stripe.