Syncing next and main

.claude-plugin/marketplace.json

@@ -9,8 +9,13 @@
       "name": "firebase",
       "description": "Official Claude plugin for Firebase. Manage projects, add backend services, develop AI features, deploy & host apps, and more",
       "category": "development",
-      "tags": ["firebase", "backend", "database", "cloud-services"],
-      "source": "./claude-plugins/firebase"
+      "tags": [
+        "firebase",
+        "backend",
+        "database",
+        "cloud-services"
+      ],
+      "source": "./"
     }
   ]
-}
+}

.cursor-plugin/plugin.json

@@ -0,0 +1,30 @@
+{
+  "name": "firebase",
+  "displayName": "Firebase",
+  "version": "1.0.1",
+  "description": "The official Firebase Cursor plugin. Prototype, build, and run modern apps with Firebase's backend and AI infrastructure.",
+  "author": {
+    "name": "Firebase",
+    "email": "firebase-support@google.com",
+    "url": "https://firebase.google.com"
+  },
+  "license": "Apache-2.0",
+  "keywords": [
+    "firebase",
+    "cursor",
+    "skills",
+    "mcp",
+    "firestore",
+    "hosting",
+    "auth",
+    "storage",
+    "ailogic",
+    "backend",
+    "cloud-services"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "logo": "./assets/firebase_logo.svg",
+  "homepage": "https://github.com/firebase/agent-skills",
+  "repository": "https://github.com/firebase/agent-skills"
+}

.github/scripts/prune-skills.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+set -e
+
+# Script to prune deleted Genkit skills
+# Usage: ./prune-skills.sh
+
+echo "🧹 Pruning deleted Genkit skills..."
+
+for skill_dir in firebase-skills/skills/*; do
+  [ -d "$skill_dir" ] || continue
+  skill_name=$(basename "$skill_dir")
+  skill_md="$skill_dir/SKILL.md"
+
+  # Check if this skill is managed by Genkit
+  if [ -f "$skill_md" ]; then
+    # We use yq to check the metadata. 
+    # The '|| echo false' handles cases where the field is missing or yq fails.
+    is_managed=$(yq -f extract '.metadata["genkit-managed"] == true' "$skill_md" 2>/dev/null || echo false)
+
+    if [ "$is_managed" = "true" ]; then
+      # If managed by Genkit but not in source, delete it
+      if [ ! -d "genkit-skills/skills/$skill_name" ]; then
+        echo "🗑️ Pruning deleted skill: $skill_name"
+        rm -rf "$skill_dir"
+      fi
+    fi
+  fi
+done
+
+echo "✅ Pruning complete."

.github/scripts/sync-skills.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+set -e
+
+# Script to sync and tag Genkit skills
+# Usage: ./sync-skills.sh
+
+echo "🔄 Syncing skills from Genkit repo..."
+
+for skill_dir in genkit-skills/skills/*; do
+  [ -d "$skill_dir" ] || continue
+  skill_name=$(basename "$skill_dir")
+  dest_dir="firebase-skills/skills/$skill_name"
+
+  echo "📦 Syncing $skill_name..."
+
+  # Clean destination to ensure exact sync (remove old files)
+  if [ -d "$dest_dir" ]; then
+    rm -rf "$dest_dir"
+  fi
+  mkdir -p "$dest_dir"
+
+  # Copy new files
+  cp -r "$skill_dir/"* "$dest_dir/"
+
+  # Mark as managed by Genkit using yq
+  # The -i flag edits in place, -f process runs the filter
+  yq -i -f process '.metadata["genkit-managed"] = true' "$dest_dir/SKILL.md"
+done
+
+echo "✅ Sync complete."

.github/workflows/sync-genkit-skills.yml

@@ -0,0 +1,50 @@
+name: Sync Genkit Skills
+
+on:
+  schedule:
+    # Runs at 9:00 AM EST (14:00 UTC) on weekdays (Monday-Friday)
+    - cron: '0 14 * * 1-5'
+  workflow_dispatch: # For manual trigger
+
+permissions:
+  # Permission for writing commits and creating PRs is given through
+  # the bot account PAT.
+  contents: read
+
+jobs:
+  sync:
+    environment: genkit skills automerger cron
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout firebase/agent-skills
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          path: firebase-skills
+
+      - name: Checkout genkit-ai/skills
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          repository: genkit-ai/skills
+          path: genkit-skills
+
+      # Identifies skills managed by Genkit that have been deleted from the source repo
+      # and removes them from this repo.
+      - name: Prune Deleted Genkit Skills
+        run: firebase-skills/.github/scripts/prune-skills.sh
+
+      # Copies skills from Genkit repo, tags them with metadata, and handles updates.
+      # Note: Uses 'yq' which is pre-installed on GitHub ubuntu-latest runners.
+      - name: Sync & Tag Skills
+        run: firebase-skills/.github/scripts/sync-skills.sh
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8
+        with:
+          path: firebase-skills
+          commit-message: "chore: sync updated skills"
+          title: "chore: 🤖 Sync updated skills from Genkit"
+          branch: "sync-skills"
+          committer: Google Open Source Bot <firebase-oss-bot@google.com>
+          reviewers: joehan, ssbushi
+          token: ${{ secrets.OSS_BOT_AUTOMERGER_PAT }}

.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.DS_Store
+*.log

.mcp.json

@@ -0,0 +1,17 @@
+{
+  "mcpServers": {
+    "firebase": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "firebase-tools@latest",
+        "mcp",
+        "--dir",
+        "."
+      ],
+      "env": {
+        "IS_FIREBASE_MCP": "true"
+      }
+    }
+  }
+}

CONTRIBUTING.md

@@ -25,6 +25,24 @@ This project follows
 
 ## Contribution process
 
+### main and next branches
+
+This repo has 2 protected branches, `main` and `next`. `main` is the default branch, and most users will use the skills here. `next` is used for development and will contain new skills and improvements that are being staged for release.
+
+If you are making an incremental improvement to an existing skill, point your PR to the `main` branch. 
+
+If you are adding a new skill, adding support for a new platform or making a significant change to an existing skill, point your PR to the `next` branch.
+
+### Testing skills
+
+To test out your skill, you can install it from a branch using the 'skills' CLI tool:
+
+```bash
+npx skills add  https://github.com/firebase/skills/tree/<branch-name>
+```
+
+We also have an automated eval pipeline set up in [firebase-tools](https://github.com/firebase/firebase-tools/tree/main/scripts/agent-evals) that is set up to pull content from this repo and run it against a set of test cases. You should add your own test cases there for your skill, both to check activation on the prompts you expect to trigger it, and to check that agents succeed on the tasks you expect it to help with. 
+
 ### Code reviews
 
 All submissions, including submissions by project members, require review. We

README.md

@@ -1,4 +1,8 @@
-# Firebase Agent Skills
+<h1 align="center">
+  <img src="assets/firebase-agent-skills_logo.svg" width="48" alt="Logo" style="vertical-align: middle; margin-right: 10px;">
+  Firebase Agent Skills
+</h1>
+
 
 A collection of skills for AI coding agents, to help them understand and work with Firebase more effectively. 
 
@@ -27,7 +31,7 @@ gemini extensions install https://github.com/firebase/skills
 1. Add the Firebase marketplace for Claude plugins:
 
 ```bash
-claude plugin marketplace add firebase/firebase-tools
+claude plugin marketplace add firebase/skills
 ```
 
 Install the Claude plugin for Firebase:
@@ -50,7 +54,34 @@ claude plugin marketplace list
 git clone https://github.com/firebase/skills.git
 ```
 
-2. Copy the contents of the `skills` directory to the appropriate location for your AI tool.
+2. Copy the contents of the `skills` directory to the appropriate location for your AI tool. Common locations include:
+   - **Cursor**: `.cursor/rules/`
+   - **Windsurf**: `.windsurfrules/`
+   - **GitHub Copilot**: `.github/copilot-instructions.md` (or project-specific instruction files)
+
+### Option 5: Local Path via Agent Skills CLI
+
+The `skills` CLI also supports installing skills from a local directory. If you have cloned this repository, you can add skills by pointing the CLI to your local folder:
+
+```bash
+npx skills add /path/to/your/local/firebase-skills/skills
+```
+
+If you make changes to the local skills repository and want to update your project with the new changes, you can update them by running:
+
+```bash
+npx skills experimental_install
+```
+
+### Option 6: Local Development (Live Symlinking)
+
+If you are actively contributing to or developing these skills, using `npx skills add` or copying files means you have to manually update them every time you make a change. Instead, use a symlink so that changes in your local clone are immediately reflected in your test project.
+
+For example, to test with Cursor:
+
+```bash
+ln -s /path/to/firebase-skills/skills /path/to/your/test-project/.cursor/rules
+```
 
 ## 🤝 Contributing
 

gemini-extension.json

@@ -11,5 +11,39 @@
         "IS_GEMINI_CLI_EXTENSION": "true"
       }
     }
-  }
+  },
+  "themes": [
+    {
+      "name": "firebase-default-dark",
+      "type": "custom",
+      "background": {
+        "primary": "#212121",
+        "diff": {
+          "added": "green",
+          "removed": "red"
+        }
+      },
+      "text": {
+        "primary": "#E8E8E8",
+        "secondary": "#A6A6A6",
+        "link": "#7CACF8",
+        "accent": "#0B57D0",
+        "response": "#7CACF8"
+      },
+      "status": {
+        "success": "#6DD58C",
+        "warning": "#FFB300",
+        "error": "#E46962"
+      },
+      "border": {
+        "default": "#2F3032",
+        "focused": "#2F3032"
+      },
+      "ui": {
+        "comment": "#DD2C00",
+        "symbol": "#2F3032",
+        "gradient": ["#FFC400", "#FF9100", "#DD2C00"]
+      }
+    }
+  ]
 }