Firebase Development

Overview

• firebase-development:project-setup

  - Initialize new Firebase projects

• firebase-development:add-feature

  - Add functions/collections/endpoints

• firebase-development:debug

  - Troubleshoot emulator and runtime issues

• firebase-development:validate

  - Review Firebase code for security/patterns

When This Skill Applies

• Starting new Firebase projects
• Adding Cloud Functions or Firestore collections
• Debugging emulator issues or rule violations
• Reviewing Firebase code for security and patterns
• Setting up multi-hosting configurations
• Implementing authentication (API keys or Firebase Auth)

Routing Logic

Keywords by Sub-Skill

• "new firebase project", "initialize firebase", "firebase init"
• "set up firebase", "create firebase app", "start firebase project"

• "add function", "create endpoint", "new tool", "add api"
• "new collection", "add feature", "build", "implement"

• "error", "not working", "debug", "emulator issue"
• "rules failing", "permission denied", "troubleshoot", "deployment failed"

• "review firebase", "check firebase", "validate", "audit firebase"
• "look at firebase code", "security review"

Routing Process

1. Analyze Request: Check for routing keywords
2. Match Sub-Skill: Identify best match based on keyword density
3. Announce: "I'm using the firebase-development:[sub-skill] skill to [action]"
4. Route: Load and execute the sub-skill
5. Fallback: If ambiguous, use AskUserQuestion with 4 options

Fallback Example

Question: "What Firebase task are you working on?"
Options:
  - "Project Setup" (Initialize new Firebase project)
  - "Add Feature" (Add functions, collections, endpoints)
  - "Debug Issue" (Troubleshoot errors or problems)
  - "Validate Code" (Review against patterns)

Reference Projects

/Users/dylanr/work/2389/oneonone

/Users/dylanr/work/2389/bot-socialmedia-server

/Users/dylanr/work/2389/meme-rodeo

Pattern Summaries

Multi-Hosting Setup

site:

target:

docs/examples/multi-hosting-setup.md

Authentication

docs/examples/api-key-authentication.md

Cloud Functions Architecture

app.post('/mcp', handler)

posts.ts

journal.ts

docs/examples/express-function-architecture.md

Security Model

docs/examples/firestore-rules-patterns.md

Emulator-First Development

firebase emulators:start
# Access UI at http://127.0.0.1:4000

• singleProjectMode: true

  - Essential for emulators to work together

• ui.enabled: true

  - Access debug UI

docs/examples/emulator-workflow.md

Modern Tooling Standards

tsconfig.json

vitest.config.ts

biome.json

ABOUTME Comment Pattern

// ABOUTME: Brief description of what this file does
// ABOUTME: Second line with additional context

Testing Requirements

• Unit tests: Test handlers/utilities in isolation
• Integration tests: Test with emulators running
• Both required for every feature

Common Gotchas

lsof -i :5001

app.use(cors({ origin: true }))

Summary

1. Detects intent via keywords
2. Routes to appropriate sub-skill
3. Sub-skills use TodoWrite checklists
4. All reference shared patterns in

   docs/examples/

• firebase-development:project-setup

  - Initialize new projects

• firebase-development:add-feature

  - Add functions/collections

• firebase-development:debug

  - Troubleshoot issues

• firebase-development:validate

  - Review code