* Explanding out contributor guidelines (#3) * update claude plugin marketplace command to use the new repo (#2) * add kiro power (#4) * update license (#8) * Adding a token counting script (#11) * Next -> Main (#16) * Add firebase-data-connect-basics skill (#7) * Add firebase-data-connect-basics skill * Add firebase dataconnect basic skills --------- Co-authored-by: Muhammad Talha <muhammadtalhar@google.com> * [Dataconnect] Restructure SKILL.md into a development workflow guide --------- Co-authored-by: Muhammad Talha <muhammadtalhar@google.com> Co-authored-by: Muhammad Talha <126821605+mtr002@users.noreply.github.com> * Adding a Cursor plugin (#13) * Add Cursor plugin configuration * Add logo to cursor plugin config * Move logo to assets directory * Restructure Cursor plugin to multi-plugin format * Clean up language * Use a symlink instead * Add theme to GCLI extension (#17) * Remove curl|bash (#18) * Update SKILL.md to remove references to 2.5 and instead use `latest`. (#19) * feat: Add sync job for genkit-ai/skills (#23) * Change to use `npx` to invoke Firebase CLI (#26) Change all `firebase` shell command mentioned in the skills to use `npx -y firebase-tools@latest` instead to ensure freshness and reduce frictions to the agents. * use pat for cla reasons (#29) * fix: update workflow title and committer details (#33) * Move the local environment setup to a new skill + MCP setup (#31) - Move all one-time-only local environment setup from `firebase-basic` to `firebase-local-env-setup` skill - Add description about how to install skills and MCP server. * fix: Add reviewers to sync-genkit-skills workflow (#35) Based on https://github.com/peter-evans/create-pull-request?tab=readme-ov-file#action-inputs * chore: sync updated skills (#34) Co-authored-by: ssbushi <66321939+ssbushi@users.noreply.github.com> * Update skill names in security rules documentation (#37) * Support Agent Skills for Firestore Enterprise with Native Mode (#27) * Add agent skills for firestore enterprise with native mode * Amend SKILL.md * Format SKILL * Address comments and rename standard edition * Remove files & update frontmatter * Updated to use "npx firebase-tools@latest" --------- Co-authored-by: Sichen Liu <sichenliu@google.com> Co-authored-by: Joe Hanley <joehanley@google.com> * update the skill verification instruction (#38) * chore: sync updated skills (#39) * gemini-3-pro-preview --> gemini-3.1-pro-preview (#40) * Refine `firebase-local-env-setup` instructions for agents (#41) Updated the installation reference guides for all supported agents (Antigravity, Claude Code, Cursor, Gemini CLI, GitHub Copilot, and others) in the `firebase-local-env-setup` skill. - Added detailed steps to locate, verify, and safely merge MCP configurations (`mcp.json`, `claude_desktop_config.json`, etc.) without overwriting existing entries. - Added explicit instructions to check for existing skill installations using `npx skills list` before installing. - Enforced "stop and wait" instructions for user restarts to ensure the agent correctly verifies the MCP server connection securely. * Update `firebase-basics` skills (#42) * Update `firebase-basics` skills - Optimize description so that it is more likely to be loaded - Clearly state the prerequisites, how to validate them and how to meet them. - Add principles about how to optimize agent ability to help with Firebase related task - Indexing other knowledges for progressive disclosure. Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> * Update `firebase-basics` skill and `firebase-local-env-setup` skill (#43) - Update their description so that firebase-basics can be picked up more consistently - Update instructions about how to refresh skills for Antigravity and other agents. * Split out python sdk content (#45) * Fixing up Cursor plugin format (#46) * docs: Improve local installation instructions (#47) * docs: improve local installation instructions * docs: address reviewer feedback on local installation instructions * adjusting cursor plugin to reflect skills and mcp setup path correctly (#52) * adjusting cursor plugin to reflect skills and mcp setup path correctly * Apply suggestion from @gemini-code-assist[bot] Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> * update mcp path to ensure it can find it * correct the path --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> * Add new skills logo (#51) * re-organize claude plugins (#54) * Moving battlehardened AI studio prompt into skills (#53) * Moving battlehardened AI studio prompt into skills * PR fixes * Address PR feedback: add isRecent, isAdmin, fix regex escaping and numbering * PR fixes * PR fixes * Merge `firebase-local-env-setup` skills into `firebase-basics` (#56) * Change all `firebase` CLI reference to use `npx firebase-tools` (#61) --------- Co-authored-by: Charlotte Liang <chliang@google.com> Co-authored-by: Muhammad Talha <muhammadtalhar@google.com> Co-authored-by: Muhammad Talha <126821605+mtr002@users.noreply.github.com> Co-authored-by: christhompsongoogle <106194718+christhompsongoogle@users.noreply.github.com> Co-authored-by: Samuel Bushi <66321939+ssbushi@users.noreply.github.com> Co-authored-by: chkuang-g <31869252+chkuang-g@users.noreply.github.com> Co-authored-by: Morgan Chen <morganchen12@gmail.com> Co-authored-by: Google Open Source Bot <firebase-oss-bot@google.com> Co-authored-by: cmoiccool <cmoiccool@users.noreply.github.com> Co-authored-by: Sichen Liu <lscmirror@gmail.com> Co-authored-by: Sichen Liu <sichenliu@google.com> Co-authored-by: Rosário P. Fernandes <rosariofernandes51@gmail.com> Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Peter Friese <peter@peterfriese.de>
2.8 KiB
Firebase Agent Skills
A collection of skills for AI coding agents, to help them understand and work with Firebase more effectively.
Skills are packaged instructions and scripts that extend agent capabilities, following the Agent Skills format.
Installation
Option 1: Agent Skills CLI
For most popular AI-assistive tools, you can use the skills CLI to install Firebase agent skills:
npx skills add firebase/skills
Option 2: Gemini CLI Extension
This repository is configured as a Gemini CLI extension. You can add it using the Gemini CLI:
gemini extensions install https://github.com/firebase/skills
Option 3: Claude Plugin
- Add the Firebase marketplace for Claude plugins:
claude plugin marketplace add firebase/skills
Install the Claude plugin for Firebase:
claude plugin install firebase@firebase
Verify the installation:
claude plugin marketplace list
Option 4: Manual Set Up
- Clone this repository:
git clone https://github.com/firebase/skills.git
- Copy the contents of the
skillsdirectory 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)
- Cursor:
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:
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:
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:
ln -s /path/to/firebase-skills/skills /path/to/your/test-project/.cursor/rules
🤝 Contributing
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'Add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request (PR)
📄 License
This project is licensed under the Apache 2 License - see the LICENSE file for details.
Made with ❤️ from Firebase for the AI community