Index of every page on this site: llms.txt
All skills
firebase avatar

/firebase-basics

@99954a3 official
by firebasefirebase/agent-skills520 stars
116
Run it yourself

Provides foundational Firebase CLI setup, CLI installation, version checks (`firebase-tools@latest --version`), CLI login (including --no-localhost), project creation, project selection (`firebase use`), and app config file downloads (`google-services.json`, `GoogleService-Info.plist`). Use ONLY for CLI login, project creation/switching, or downloading app config files. Don't use for Firebase Hosting deploy, Firestore, Auth, App Hosting, Data Connect, Crashlytics, or Remote Config.

Use this Skill: https://skilld.dev/gh/firebase/agent-skills/firebase-basics

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈126 tokens for metadata: the name and description. ≈1.7k when used: this file. ≈13k more on demand in 19 files.

Description uses 6.3% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈504 characters, or 6.3%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Prerequisites

Complete these setup steps before proceeding:

  1. Local Environment Setup: Verify the environment is properly set up so we can use Firebase tools:

  2. Authentication: Ensure you are logged in to Firebase so that commands have the correct permissions. Run npx -y firebase-tools@latest login:list first; if not logged in, run npx -y firebase-tools@latest login. For environments without a browser (e.g., remote shells), use npx -y firebase-tools@latest login --no-localhost.

    • The command should output the current user.
    • If you are not logged in, follow the interactive instructions from this command to authenticate.
  3. Active Project: Most Firebase tasks require an active project context.

    [!IMPORTANT] For Agents: If no Project ID was provided, you MUST pause and ask the developer if they prefer to:

    1. Provide an existing Firebase Project ID, or
    2. Create a new Firebase project.
    • If using an existing Project ID:

      1. Check the current project with npx -y firebase-tools@latest use (if firebase.json is missing at the project root, create {} first).

      2. If the command outputs Active Project: <project-id>, confirm with the user if this is the intended project.

      3. If not, or if no project is active, set the project provided by the user:

        npx -y firebase-tools@latest use <PROJECT_ID>
    • If creating a new project: Run the following command to create it:

      npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"

      Note: The <project-id> must be 6-30 characters, lowercase, and can contain digits and hyphens. It must be globally unique.

Firebase Usage Principles

Adhere to these principles:

  1. Use npx for CLI commands: To ensure you always use the latest version of the Firebase CLI, always prepend commands with npx -y firebase-tools@latest instead of just firebase. For example, use npx -y firebase-tools@latest --version. NEVER suggest the naked firebase command as an alternative.
  2. Prioritize official knowledge: For any Firebase-related knowledge, consult the developerknowledge_search_documents MCP tool before falling back to Google Search or your internal knowledge base. Including "Firebase" in your search query significantly improves relevance.
  3. Follow Agent Skills for implementation guidance: Skills provide opinionated workflows (CUJs), security rules, and best practices. Always consult them to understand how to implement Firebase features correctly instead of relying on general knowledge.
  4. Use Firebase MCP Server tools instead of direct API calls: Whenever you need to interact with remote Firebase APIs (such as fetching Crashlytics logs or executing Data Connect queries), use the tools provided by the Firebase MCP Server instead of attempting manual API calls.
  5. Keep Plugin / Agent Skills updated: Since Firebase best practices evolve quickly, regularly check for and install updates to their Firebase plugin or Agent Skills. Similarly, if you encounter issues with outdated tools or commands, follow the steps below based on your agent environment:
  6. Automate Config File Retrieval: When setting up iOS or Android apps, do NOT direct users to the Firebase Console to download google-services.json or GoogleService-Info.plist. Instead, use the Firebase CLI to fetch the config programmatically:
    • For Android: npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>
    • For iOS: npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID> Save the output to the appropriate location (e.g., app/google-services.json for Android, or a path to be linked by xcode-project-setup for iOS).

References

Common Issues

  • Login Issues: If the browser fails to open during the login step, use npx -y firebase-tools@latest login --no-localhost instead.

  • Genkit: If using Genkit, install the skills:

    npx skills add genkit-ai/skills

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

2 warnings29d5 checks · Risk SAFE
  • Gen Agent Trust Hub29d

    This skill provides a secure environment for setting up and managing Firebase projects via the CLI. It includes comprehensive instructions for authentication, project creation, and SDK integration across Web, Android, iOS, and Flutter. All external resources and tools are sourced from trusted official repositories, and the skill includes proactive security guidance to prevent the exposure of sensitive debug credentials.

  • Socket1mo

    1 alert: gptAnomaly

  • Snyk1mo

    Risk: LOW · No issues

  • Runlayer8mo

    1/2 files flagged

  • ZeroLeaks7mo

    1 finding · Score: 69/100

Signed by skilld at 99954a3. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated last month
Other metadata
metadata
{
  "author": "Google LLC",
  "category": "CloudInfrastructureAndServices",
  "version": "1.0.0"
}
  • firebase
  • firebase-cli
  • authentication
  • project-setup
  • google-services
  • web
  • android
  • ios

README badge

README badge for firebase/agent-skills/firebase-basics

Provides foundational Firebase CLI setup, authentication, and project management for initializing Firebase environments. Use for checking the Firebase CLI version, logging in, setting active projects, and retrieving config files like google-services.json for Android or GoogleService-Info.plist for iOS.

Generated from the current SKILL.md.

Does this skill handle Firebase authentication setup?
Yes. It covers Firebase CLI authentication via `npx -y firebase-tools@latest login`, including the `--no-localhost` flag for environments without a browser.
What Firebase operations does this skill support?
It provides CLI-based workflows for checking Firebase CLI version, initializing Firebase environments, authenticating, managing active projects, and retrieving `google-services.json` and `GoogleService-Info.plist` config files for Android and iOS apps.
Can I use this skill to create a new Firebase project?
Yes. The skill includes the `npx -y firebase-tools@latest projects:create` command to create new projects with a globally unique project ID.
Does this skill work with Genkit?
The skill acknowledges Genkit usage and notes that the genkit-ai/skills package should be installed separately when using Genkit.

Generated from the current SKILL.md. These answers refresh after source changes.