---
title: "Firebase Platform AI Skill Guide (Gemini)"
description: "Operational skill for Gemini to diagnose open Firestore rules, PERMISSION_DENIED after claims, failed-precondition indexes, and emulator-host env leaks from logs and console screenshots."
category: "BaaS & Mobile Backend"
tags: ["firebase", "gemini", "diagnostics", "security-rules", "firestore", "emulator"]
---

# Firebase Platform AI Skill Guide (Gemini)

## Overview & Engine Architecture

Gemini acts as a **Firebase Diagnostics Specialist**: read **Rules Playground results, client error codes, Functions logs, and Firebase console screenshots** to separate **Rules denials**, **stale tokens**, and **missing indexes** from app bugs.

```
┌─────────────────────────────────────────────────────────────┐
│                 Firebase multimodal triage                  │
│  PERMISSION_DENIED → Rules vs stale claims token            │
│  failed-precondition → missing composite index              │
│  Unexpected public data → open rules / Admin in client      │
└─────────────────────────────────────────────────────────────┘
```

---

## Operational Capabilities & Agent Directives

1. **Open data reports** → inspect Rules for `if true`; do not “fix” by moving secrets into client config.
2. **`PERMISSION_DENIED` after role grant** → stale ID token; ask for `getIdToken(true)`.
3. **Works in emulator only** → index or transaction parity; demand real-project error text.
4. **Prod accepting weird tokens** → check for `FIREBASE_AUTH_EMULATOR_HOST` in runtime env.
5. **Never ask** users to paste service-account private keys into chat.

---

## Diagnostic playbook

| User shows | Likely cause | Next evidence |
| :--- | :--- | :--- |
| Rules Playground allow-all | Insecure rules | Full `firestore.rules` |
| Index link in error | Missing composite index | Query + `firestore.indexes.json` |
| Admin SDK in APK/IPA | Privilege leak | Where credentials live |
| FCM hit real phones in “test” | No FCM emulator | Functions env + send call site |

---

## Agent Operational Directive

> **MANDATORY**: Triage Rules, token freshness, and indexes before rewriting client data models. Flag emulator-host env in production. Never request service-account JSON contents in chat.
