firebase-ai-logic-basics Skill for Claude: Call Gemini From Your App

firebase-ai-logic-basics, from Google's Firebase team, guides your agent to add Gemini features to Android, iOS, web and Flutter apps with Firebase AI Logic.

Installs: 139.2K; on skills.sh
Stars: 497; on GitHub
Files: 5; besides SKILL.md
Updated: Oct 2026; last repo commit

firebase-ai-logic-basics teaches the agent to add generative AI to an app with Firebase AI Logic (formerly Vertex AI for Firebase), where client SDKs call Gemini models without a backend you run. It covers Android (Kotlin), iOS (Swift), web and Flutter.

The key step: even in a project that already uses Firebase, the agent must run init ailogic to provision the service, or requests fail with PERMISSION_DENIED. It defaults to the Gemini Developer API (free tier, then pay-as-you-go) and uses the Agent Platform Gemini API only if the app needs it, which requires the Blaze plan.

It names the capabilities it covers and insists on App Check and on current Gemini 3 or newer model names, never older Gemini 1.x or 2.x models.

Good for

Mobile and web developers adding chat, text, image or audio features with Gemini
Teams that want to call Gemini from client code without their own backend
Developers who need App Check set up for AI quota safety

Install firebase-ai-logic-basics

Claude Code

Copy this prompt.

Install the firebase-ai-logic-basics skill in Claude Code. Run this command:

claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 20+, Google account.

The plugin route is the one the Firebase skills recommend for Claude Code. It installs all 13 skills in the repo and a Firebase MCP server, which .mcp.json starts with npx -y firebase-tools@15.32.1 mcp --dir . (version at review time). Restart Claude Code afterwards. The skills CLI route installs only the skills named. Every route needs Node.js 20 or newer, and the skills run the Firebase CLI through npx, so you also sign in to Firebase with a Google account. The README writes the marketplace as firebase/skills; the repository is firebase/agent-skills, the name the vendor Claude Code setup guide uses.

From the vendor's docs. Source.

What's in the skill

When it loads

Integrates Firebase AI Logic (formerly Vertex AI for Firebase) into mobile and web apps (Android, iOS, Web, and Flutter) to call Gemini models from client code. Use when provisioning or initializing Firebase AI Logic, or adding Gemini features to an app: text generation, multimodal input, chat, streaming, structured output, hybrid on-device inference, App Check protection, or switching models with Remote Config.

Sections in SKILL.md

Overview
Setup & initialization
Prerequisites
1. Provision Firebase AI Logic (ALL platforms)
2. Add the SDK and initialize the service in the app
Core Capabilities
Text-Only Generation
Multimodal (Text + Images/Audio/Video/PDF input)
Chat Session (Multi-turn)
Streaming Responses
Text-to-Speech (TTS) Generation
Generate Images with Nano Banana
Search Grounding with the built in googleSearch tool
Supported Platforms and Frameworks
Advanced Features
Structured Output (JSON)

Key facts

Author: firebase (GitHub: firebase)
Repo: firebase/agent-skills
License: Apache-2.0 (LICENSE and README); the Claude plugin.json says MIT
Installs on skills.sh: 139,190 as of 2026-11-02
GitHub stars (whole repo): 497 as of 2026-11-02
Last repo commit: 2026-10-30
Files: 6 files including SKILL.md (5 reference guides), no scripts
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
Made by: Google LLC (SKILL.md metadata); the Claude plugin calls itself the official Claude plugin for Firebase
Category: AiAndMachineLearning

What it includes

npx firebase-tools init ailogic, required on every platform
Checks the project and an app for your platform, then runs init ailogic, which enables the Gemini Developer API in the project. If it cannot run it, the agent tells you the command.
Runs code · Provision
generateContent, startChat, generateContentStream
Text-only generation, image, audio, video and PDF input, multi-turn chat, and streaming partial results. Files over 20 MB go through Cloud Storage for Firebase.
Text, multimodal, chat, streaming
Client-side speech with Gemini TTS models
Single-speaker voices and two-speaker dialogue, streaming audio, audio directives and emotional tags. A dedicated 22 KB guide has snippets for iOS, Android and web.
Text-to-speech
Nano Banana image models; googleSearch tool
Image generation needs the Blaze pay-as-you-go plan. Search grounding uses the built-in googleSearch tool.
Image generation, search grounding
JSON schema output; on-device with cloud fallback
Enforce a JSON schema for responses. Hybrid inference runs on-device when a model is available and falls back to the cloud.
Structured output and on-device hybrid
Required for safe use; debug tokens for local and CI
Debug tokens bypass attestation, so the skill says never hardcode or commit them. Inject them through env variables, gitignored config or CI secrets.
App Check
Change model versions without a client release
The skill suggests keeping model names in Remote Config instead of hardcoding them.
Remote Config for model names
Android, iOS, web, Flutter, TTS
Five reference files: usage_patterns_android, ios_setup, usage_patterns_web, flutter_setup and tts_generation.
Platform references

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It turns on a Gemini API in your project
init ailogic enables the Gemini Developer API in the project. Some features, like image generation, need the Blaze billing plan. github.com
Unprotected AI calls can burn your quota
The SKILL.md says you must set up App Check so unauthorized clients cannot use your quota. Never commit App Check debug tokens or put them in client code. github.com
It runs the latest Firebase CLI through npx
Commands use npx -y firebase-tools@latest, which downloads and runs the newest published package each time. You sign in to Firebase with your Google account. github.com
The plugin route adds a Firebase MCP server
The Firebase plugin ships an .mcp.json that starts `npx -y firebase-tools@15.32.1 mcp --dir .` with IS_FIREBASE_MCP=true, so a Firebase MCP server runs in your project folder. The pinned version was 15.32.1 at review time. The skills CLI route does not add it. github.com

Technical details

Talks to	Firebase and Google Cloud through the Firebase CLI
Scopes	Google account signed in to the Firebase CLI

Questions

What does firebase-ai-logic-basics do?

It guides your agent to add Gemini features to a mobile or web app through Firebase AI Logic: provisioning the service, adding the SDK and writing code for text, chat, multimodal input, speech and more.

How do I install it in Claude Code?

Use the install box above. The plugin route installs every Firebase skill and the MCP server. The skills CLI route installs this skill and firebase-basics, which its SKILL.md uses to check Node.js and log in.

Why does my Gemini call fail with PERMISSION_DENIED?

The SKILL.md says the service was not provisioned. Config files like google-services.json do not enable it, so run npx -y firebase-tools@latest init ailogic in the project.

Does it cost money?

The Gemini Developer API has a free tier for prototyping and pay-as-you-go for production. The Agent Platform Gemini API and image generation need the Blaze plan, per the SKILL.md. It does not list prices.

Does it need an API key?

No API key is named in the SKILL.md. The Firebase CLI signs in with your Google account (npx -y firebase-tools@latest login), and most tasks need an active Firebase project. Apps call Gemini through Firebase, protected by App Check.

Is firebase-ai-logic-basics safe to use?

It changes your project by enabling the Gemini API and adds SDK code to your app. Without App Check, others could use your AI quota, which is why the skill requires it. Never commit debug tokens.

Information

updated Nov 2, 2026

Repository: firebase/agent-skills
Folder: skills/firebase-ai-logic-basics

firebase/agent-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

agent-skills README · github.com
firebase-basics Claude Code setup · github.com
Firebase plugin .mcp.json · github.com
firebase-basics Cursor setup · github.com
firebase-ai-logic-basics SKILL.md · github.com
github.com · github.com