Skip to content
Firebase Firestore

Firebase Firestore Skill

Firebase's official skill for Cloud Firestore: it detects or creates the database, picks the Standard or Enterprise edition guides, and covers provisioning, data modelling, indexes, security rules and SDK setup for Web, Python, iOS, Android and Flutter.

GitHub Docs

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from firebase/agent-skills.

$ npx skills add firebase/agent-skills --skill firebase-firestore

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects.

Other ways to install

Copy the whole skill folder — SKILL.md and any scripts or references beside it — into ~/.claude/skills/firebase-firestore/, where Claude Code picks it up in every project. Only git is needed.

tmp=$(mktemp -d) && \
  git clone --depth 1 --branch main https://github.com/firebase/agent-skills.git "$tmp" && \
  mkdir -p ~/.claude/skills && \
  cp -R "$tmp"/skills/firebase-firestore ~/.claude/skills/firebase-firestore

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/firebase-firestore/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

About

  • Detects existing Firestore databases and their edition before any change
  • Creates an Enterprise edition database with a user-chosen location when none exists
  • Separate Standard and Enterprise reference guides for provisioning, indexes and SDKs
  • SDK setup for Web, Android, iOS and Flutter, plus Python on Enterprise
  • Always configures and deploys firestore.rules, delegating rule writing to a dedicated subagent or skill
  • Runs through the Firebase CLI via npx firebase-tools@latest

Firebase Firestore is the database skill in the firebase/agent-skills repository, the set of skills Firebase publishes for coding agents. It is meant for adding Cloud Firestore to an app or working on an existing database: provisioning, data modelling, queries, indexes, security rules and client or server SDK integration.

The skill's first rule is to identify which Firestore edition the agent is dealing with before writing any model or rule. It lists databases with firebase-tools firestore:databases:list, inspects each one, and asks the user which to target. A Standard edition database sends the agent to the references/standard/ guides; an Enterprise edition or native-mode database to references/enterprise/. If there is no database, it defaults to creating an Enterprise edition instance, after asking the user for a location from firestore:locations and suggesting one next to their other resources.

Each edition has its own references for provisioning, indexes and SDK usage (Web, Android, iOS and Flutter for both, plus Python and a data-model guide for Enterprise), and for Enterprise the agent must read the relevant platform guide before writing application code. Security rules get special treatment: whenever a Firestore-backed app is set up or firestore.rules changes, the agent configures the rules file in firebase.json and deploys it, even when the server uses the Admin SDK, delegating the writing to a firestore-rules-author subagent when one is available or following the firestore-rules-creation skill otherwise. It works best with the Firebase CLI, run through npx -y firebase-tools@latest, and needs a Firebase project. Apache-2.0.

SKILL.md

The instructions your agent loads, as published by Firebase.

SKILL.md
name
firebase-firestore
description
Sets up, manages, queries, and configures Cloud Firestore databases (Standard/Enterprise edition), including data modeling, security rules, indexes, and SDK integrations (Web, Admin, Python, iOS, Android, Flutter). Use when adding or migrating app databases, creating/listing Firestore databases, defining data models/indexes, writing SDK queries, or integrating Firestore SDKs. For authoring or modifying Firestore Security Rules (firestore.rules), delegate to the firestore-rules-author subagent if subagent delegation is available, or use firestore-rules-creation otherwise. Don't use for Data Connect, BigQuery, or standalone Hosting, Auth, Storage/GCS, Crashlytics, or Functions tasks.
compatibility
This skill is best used with the Firebase CLI, but does not require it. Firebase CLI can be accessed through `npx -y firebase-tools@latest`.
metadata
author: Google LLC category: Databases

Cloud Firestore Database and Operations

[!IMPORTANT] Security Rules Authoring (`firestore.rules`) Whenever setting
up a Firestore-backed app or creating/modifying firestore.rules, configure
"firestore": { "rules": "firestore.rules" } in firebase.json and deploy
firestore.rules
(npx -y firebase-tools@latest deploy --only firestore:rules), even if server
routes use the Admin SDK:

- **If subagent delegation AND the firestore-rules-author subagent are
available**: delegate authoring firestore.rules to the
firestore-rules-author subagent rather than writing firestore.rules
directly in the main agent.
- If subagent delegation is unavailable (e.g., subagents not enabled in
the IDE) OR `firestore-rules-author` is not installed: read and follow
the firestore-rules-creation skill to write firestore.rules directly.

Before setting up dependencies, writing data models, or configuring security
rules, you MUST always identify the Firestore instance edition.

1. Instance Selection and Edition Detection

Run the following command to list current Firestore databases:

npx -y firebase-tools@latest firestore:databases:list
A. Instance Found
  1. For each database found, inspect its edition and details:
   npx -y firebase-tools@latest firestore:databases:get <database-id>
  1. Ask the user which database instance they wish to target or if they would

prefer to create a new instance.

  1. Once the target instance is established:
  • If the `edition` is STANDARD, follow the guides under

references/standard/.

  • If the `edition` is ENTERPRISE or native mode, follow the guides

under references/enterprise/.

B. No Instance Found (or New Requested)

If no databases exist or the user requests a new one, default to provisioning an
Enterprise edition database and ask the user what location to use. Run
npx -y firebase-tools@latest firestore:locations to get the list of options.
Suggest colocating with other resources if applicable.

Once the location is determined, create the database:

npx -y firebase-tools@latest firestore:databases:create <database-id> --edition="enterprise" --location="<selected-location>"

Proceed with using the guides under references/enterprise/.

______________________________________________________________________

2. Specialized Guides

Based on the identified or created instance edition, open and read the
corresponding reference guides:

Standard Edition (references/standard/)
  • Provisioning: Read [provisioning.md](references/standard/provisioning.md)
  • Security Rules: See the firestore-rules-creation skill
  • SDK Usage: Read [web_sdk_usage.md](references/standard/web_sdk_usage.md),

[android_sdk_usage.md](references/standard/android_sdk_usage.md),
[ios_setup.md](references/standard/ios_setup.md), or
[flutter_setup.md](references/standard/flutter_setup.md)

  • Indexes: Read [indexes.md](references/standard/indexes.md)
Enterprise Edition / Native Mode (references/enterprise/)
  • Provisioning: Read

[provisioning.md](references/enterprise/provisioning.md)

  • Data Model: Read [data_model.md](references/enterprise/data_model.md)
  • Security Rules: See the firestore-rules-creation skill
  • SDK Usage:

> [!CRITICAL] Mandatory Reference Reading Before writing or modifying any
> application code for Firestore Enterprise Edition, you MUST read at
> least one of the relevant reference documents below for the target
> platform/language to understand specific architectural requirements and
> pipeline initialization patterns.

Read [web_sdk_usage.md](references/enterprise/web_sdk_usage.md),
[python_sdk_usage.md](references/enterprise/python_sdk_usage.md),
[android_sdk_usage.md](references/enterprise/android_sdk_usage.md),
[ios_setup.md](references/enterprise/ios_setup.md), or
[flutter_setup.md](references/enterprise/flutter_setup.md)

  • Indexes: Read [indexes.md](references/enterprise/indexes.md)
Install

Firebase's official red-team skill for auditing Firestore and Cloud Storage security rules — hunting privilege escalation, create/update bypasses and resource-exhaustion holes.

New

Firebase's official skill for adding sign-in to an app: enable providers from firebase.json, deploy the auth config, wire up the client SDK on web, Flutter, Android or iOS, and lock data down with request.auth rules.

Google's official Firebase entry-point skill — CLI login, project creation and selection, and programmatic retrieval of google-services.json and GoogleService-Info.plist.

Browse all skills →