Files
firebase__agent-skills/CONTRIBUTING.md
Joe Hanley 84b8db85ae Sync main & next (#64)
* 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>
2026-04-02 10:03:56 -07:00

2.2 KiB

How to contribute

We'd love to accept your patches and contributions to this project.

Before you begin

Sign our Contributor License Agreement

Contributions to this project must be accompanied by a Contributor License Agreement (CLA). You (or your employer) retain the copyright to your contribution; this simply gives us permission to use and redistribute your contributions as part of the project.

If you or your current employer have already signed the Google CLA (even if it was for a different project), you probably don't need to do it again.

Visit https://cla.developers.google.com/ to see your current agreements or to sign a new one.

Review our community guidelines

This project follows Google's Open Source Community Guidelines.

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:

npx skills add  https://github.com/firebase/skills/tree/<branch-name>

We also have an automated eval pipeline set up in firebase-tools 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 use GitHub pull requests for this purpose. Consult GitHub Help for more information on using pull requests.