Google Agent Skills: инструкция для Claude Code
Общий промпт не знает актуальных нюансов Firebase, Cloud Run или Gemini API. Skill даёт агенту компактную официальную инструкцию под одну конкретную задачу. Твоя работа — выбрать нужный контекст и проверить результат, а не искать идеальный универсальный запрос.
Содержание9 глав
Что это и где взять
Agent Skills — открытый формат инструкций, которые агент подгружает по необходимости. Google поддерживает официальный каталог для своих продуктов. Репозиторий развивается, поэтому перед новой задачей сверяй название и состав навыков в каталоге.
- Открой официальный репозиторий Google Skills и выбери один продукт под текущую задачу.
- Поставь каталог:
npx skills add google/skills. Для Claude Code можно подключить marketplace:claude plugin marketplace add google/skills. - Установи только нужный plugin из marketplace Google, а не весь каталог на всякий случай.
- Открой установленный
SKILL.md: там лежат обязательные предусловия, безопасные команды и критерии проверки. - Дай агенту конкретную задачу, исходники и критерий готовности. Skill не заменяет постановку задачи.
Три навыка из ролика
Firebase Basics
Для веб- или мобильного приложения на Firebase. Skill начинает с актуальных prerequisites: Node.js, Firebase Agent Skills, авторизация и выбор проекта.
Cloud Run Basics
Для HTTP-сервиса, job или worker pool в Cloud Run. До деплоя нужны проект, регион, права и понятный способ проверить опубликованный сервис.
Gemini API
Для функций на Gemini в Google Cloud или Agent Platform: выбор SDK, модели, формат ответа, ограничения и проверка вызова.
Не путай с MCP
MCP даёт доступ к инструментам и данным. Skill — это компактная инструкция, как применять конкретный продукт без лишнего контекста.
Рабочая формула задачи
Промт 18 строк · 408 знаков
Ты работаешь с [FIREBASE / CLOUD RUN / GEMINI API]. Цель: [ОДНО ИЗМЕРИМОЕ ДЕЙСТВИЕ]. Проект и папка: [ID ПРОЕКТА / ПУТЬ]. Ограничения: [РЕГИОН, БЮДЖЕТ, ДАННЫЕ, ЧТО НЕ МЕНЯТЬ]. Используй установленный официальный skill и выполни его обязательные prerequisites. Перед завершением: проверь [ТЕСТ / URL / ЛОГ / ПРАВА]. В ответе покажи: что сделано, команды, результат проверки и что требует моего подтверждения.
Чек-лист перед запуском
| Проверь | Зачем |
|---|---|
| Аккаунт и активный проект | Агент не должен создать или изменить ресурс в чужом проекте. |
| Минимальные права | Выдавай ровно тот доступ, который нужен на задачу; ключи и токены не вставляй в репозиторий. |
| Среда и регион | Отдельно назови test и production, регион и допустимые расходы. |
| Проверка результата | Для сервиса — URL и лог; для Firebase — тестовый сценарий; для Gemini — вход, ожидаемый выход и ошибочный случай. |
| План отката | До деплоя реши, как выключить новую функцию или вернуться к прежней версии. |
Официальные ссылки
- Старт и каталог: github.com/google/skills.
- Контекст запуска: анонс Google Cloud.
- Firebase: Firebase Basics и Firebase Agent Skills.
- Cloud Run: Cloud Run Basics.
