К основному содержанию
скилл CX Codex

firebase-ai — скилл для Claude Code: что делает и как установить

Скилл учит агента правильно подключать Firebase AI Logic в Flutter-проекте и писать код для генерации текста и чата через Gemini.

MIT ★ 674 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules
Открыть на GitHub

Что делает firebase-ai

Скилл задаёт шаблоны кода для firebase_ai в Flutter: инициализация Firebase.initializeApp, создание модели через FirebaseAI.googleAI().generativeModel, однократная генерация текста, многоходовый чат через model.startChat() и потоковый вывод через generateContentStream для построчного обновления интерфейса. Отдельно описаны мультимодальные запросы с текстом и изображением через Content.multi и InlineDataPart.

Есть блок про обработку ошибок — перехват FirebaseAIException, распознавание квот и экспоненциальный backoff, а также про безопасность: настройка safetySettings с HarmCategory и рекомендация включить App Check против злоупотреблений эндпоинтом. На Windows платформа Firebase AI не поддерживается, а на macOS и других Apple-устройствах статус — бета.

Агент опирается на эти сниппеты при правке Dart-кода, но для реальной работы нужен настроенный Firebase-проект с включённым Firebase AI Logic в консоли.

Какие задачи решает

  • настроить firebase_ai в Flutter-проекте
  • сгенерировать текстовый ответ через Gemini
  • собрать многоходовый чат с историей сообщений
  • вывести ответ модели построчно через стрим
  • отправить в Gemini запрос с текстом и изображением

Примеры запросов агенту

  • Настрой firebase_ai в проекте и инициализируй Gemini-модель
  • Сделай потоковый вывод ответа Gemini в интерфейс
  • Добавь обработку ошибок квоты для вызовов generateContent

Как установить firebase-ai

1Через маркетплейс плагинов

/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules

Команда ставит плагин flutter-ai-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add evanca/flutter-ai-rules --skill firebase-ai -a claude-code

3Вручную: положить файлы

~/.claude/skills/firebase-ai/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/firebase-ai/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о firebase-ai

Как установить firebase-ai в Claude Code?

Выполните /plugin marketplace add evanca/flutter-ai-rules, затем /plugin install flutter-ai-skills@flutter-ai-rules.

Что делает скилл firebase-ai?

Он задаёт правильные шаблоны кода для настройки Firebase AI Logic в Flutter: инициализацию, генерацию текста и чата с Gemini, стриминг ответов, мультимодальные запросы и обработку ошибок.

На каких платформах работает Firebase AI Logic?

Полная поддержка на iOS, Android и Web, на macOS и других Apple-устройствах — бета, на Windows не поддерживается.

Исходный текст

SKILL.md · MIT
---
name: firebase-ai
description: "Use when setting up firebase_ai, generating text/chat with Gemini, streaming AI output, building multimodal prompts, or handling AI errors."
license: MIT
---

# Firebase AI Skill

This skill defines how to correctly use Firebase AI Logic in Flutter applications.

## When to Use

Use this skill when:

* Setting up and configuring Firebase AI in a Flutter project.
* Generating text content or chat responses with Gemini models.
* Implementing streaming AI responses for real-time UI updates.
* Sending multimodal prompts (text + images) to Gemini.
* Handling errors, offline scenarios, and rate limits for AI operations.
* Applying security and privacy considerations for AI features.

---

## 1. Setup and Configuration

```
flutter pub add firebase_ai
```

```dart
import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
final model =
    FirebaseAI.googleAI().generativeModel(model: 'gemini-2.5-flash');
```

- Ensure the Firebase project is configured for AI services via the Firebase AI Logic page in the Firebase Console.
- Initialize Firebase before using any Firebase AI features.
- Use `FirebaseAI.googleAI()` for the **Gemini Developer API** backend (recommended starting point).
- Implement **App Check** to prevent abuse of Firebase AI endpoints.

**Platform support:**

| Platform | Support |
|---|---|
| iOS | Full |
| Android | Full |
| Web | Full |
| macOS / other Apple | Beta |
| Windows | Not supported |

---

## 2. Generating Content

### Single-turn text generation

```dart
final response = await model.generateContent([
  Content.text('Summarize the benefits of Flutter for mobile development'),
]);
final text = response.text; // The generated summary string
```

### Multi-turn chat

```dart
final chat = model.startChat();
final response = await chat.sendMessage(
  Content.text('What is the difference between StatelessWidget and StatefulWidget?'),
);
print(response.text);

// Follow-up in the same conversation
final followUp = await chat.sendMessage(
  Content.text('When should I use StatefulWidget?'),
);
print(followUp.text);
```

### Streaming responses

Use streaming to display partial results as they arrive:

```dart
final stream = model.generateContentStream([
  Content.text('Write a step-by-step guide to implementing dark mode in Flutter'),
]);

await for (final chunk in stream) {
  // Append chunk.text to the UI progressively
  setState(() => _output += chunk.text ?? '');
}
```

### Multimodal prompts (text + image)

```dart
final imageBytes = await File('photo.jpg').readAsBytes();
final response = await model.generateContent([
  Content.multi([
    TextPart('Describe what you see in this image'),
    InlineDataPart('image/jpeg', imageBytes),
  ]),
]);
```

---

## 3. Error Handling

Wrap AI calls in structured error handling:

```dart
try {
  final response = await model.generateContent([Content.text(prompt)]);
  return response.text;
} on FirebaseAIException catch (e) {
  if (e.message?.contains('quota') ?? false) {
    // Handle rate limiting — show retry message or queue the request
    return 'Service is busy. Please try again shortly.';
  }
  return 'AI service error: ${e.message}';
} catch (e) {
  return 'Unexpected error: $e';
}
```

- Provide meaningful error messages to users when AI operations fail.
- Handle **offline scenarios** with appropriate fallback behavior (e.g., cached responses).
- Implement **exponential backoff** for rate-limited or transient errors.

---

## 4. Security and Privacy

- Follow Firebase Security Rules best practices when using AI services alongside other Firebase products.
- Ensure proper **authentication and authorization** for AI feature access.
- Sanitize user input before sending it to the model to prevent prompt injection.
- Be mindful of **data privacy requirements** when processing user content with AI services.
- Implement appropriate **content filtering and moderation** using safety settings:

```dart
final model = FirebaseAI.googleAI().generativeModel(
  model: 'gemini-2.5-flash',
  safetySettings: [
    SafetySetting(HarmCategory.harassment, HarmBlockThreshold.medium),
    SafetySetting(HarmCategory.dangerousContent, HarmBlockThreshold.high),
  ],
);
```

---

## References

- [Firebase AI Logic Flutter documentation](https://firebase.google.com/docs/ai-logic/get-started?platform=flutter)

© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules

Похожие скиллы

Все скиллы по теме «Мобильная разработка» →
firebase-ai-logic-basics Google LLC Скилл firebase-ai-logic-basics подключает Firebase AI Logic к мобильным и веб-приложениям, позволяя вызывать модели Gemini напрямую из клиентского кода без своего бэкенда. CX Codex +1 146 900установок firebase-crashlytics Google LLC Помогает настроить Firebase Crashlytics и SDK для отчётов о сбоях. Запускается при добавлении Crashlytics в Android, iOS или Web-приложение. CX Codex +1 142 900установок firebase-apk-scanner trailofbits Скилл firebase-apk-scanner разбирает Android APK, вытаскивает конфиг Firebase и проверяет базы, хранилища и функции на открытый доступ. Нужен при аудите мобильных приложений. CX Codex +1 6 000установок flutter-build-responsive-layout flutter Скилл flutter-build-responsive-layout обучает агента строить адаптивные интерфейсы Flutter под экраны телефонов и десктопов. Он задаёт правила работы с LayoutBuilder и MediaQuery. CX Codex +1 46 800установок flutter-fix-layout-issues flutter Скилл flutter-fix-layout-issues разбирает ошибки раскладки Flutter по тексту исключения: overflow, неограниченные constraints, неверный ParentData. Подсказывает, что обернуть и во что. CX Codex +1 43 700установок dart-add-unit-test dart-lang Скилл dart-add-unit-test для Claude Code, Codex и других агентов пишет и организует юнит-тесты на package:test. Включается при добавлении логики или исправлении багов, чтобы избежать регрессий. CX Codex +1 21 400установок

Из того же набора39

Весь набор →
firebase-data-connect Скилл помогает настраивать Firebase Data Connect в Flutter, описывать GraphQL-запросы и мутации, подключать типизированный SDK и разбирать офлайн-сценарии. CX Codex +1 ★ 674звёзд репо firebase-remote-config Скилл для Flutter-приложений: агент подключает Firebase Remote Config — фича-флаги, значения по умолчанию, A/B-тесты и обновления конфига без релиза. CX Codex +1 ★ 674звёзд репо firebase-cloud-functions Помогает агенту писать код для вызова Firebase Cloud Functions во Flutter: обработка ошибок, таймауты и работа с эмулятором. CX Codex +1 ★ 674звёзд репо testing Скилл testing помогает писать и проверять unit- и widget-тесты для Flutter и Dart, разбирать flaky-тесты и выбирать подходящий тип проверки. CX Codex +1 ★ 674звёзд репо flutterfire-configure Настраивает Firebase в Flutter-проектах, автоматизирует вызов flutterfire configure и помогает развести конфигурации по нескольким app flavors. CX Codex +1 ★ 674звёзд репо flutter-use-column-row-first Скилл flutter-use-column-row-first помогает собирать адаптивные Flutter-экраны на Row и Column, а фиксированные размеры оставляет для конкретных задач. Пригодится при создании и проверке интерфейсов. CX Codex +1 ★ 674звёзд репо firebase-crashlytics Скилл учит агента настраивать Firebase Crashlytics во Flutter-проектах: ловить фатальные и нефатальные ошибки, логировать асинхронные исключения, добавлять кастомные ключи и загружать символы обфусцированных сборок. CX Codex +1 ★ 674звёзд репо firebase-in-app-messaging Помогает настроить Firebase In-App Messaging во Flutter: подавлять показы на критичных экранах, настраивать сбор согласий для GDPR и тестировать кампании на тестовых устройствах. CX Codex +1 ★ 674звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой