Firebase Cpp Formatter Agent Skill
Formatting workflow for C++ and Objective-C code in the Firebase C++ SDK. Use when modifying source code and ensuring compliance with the repository's clang-format rules.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/firebase/firebase-cpp-sdk --skill firebase-cpp-formatterThe instruction itself
7 sections, as written by the authorCode Formatting for Firebase C++ SDK
This skill provides instructions on how to properly format C++ and Objective-C
code before creating a pull request or committing changes in the
firebase-cpp-sdk repository. The primary tool is scripts/format_code.py.
Prerequisites
Before running the formatting script, ensure that your Python environment is set up with all required dependencies:
- Python Dependencies: Run
pip install -r scripts/gha/python_requirements.txtto install the required libraries (such asattrs,absl-py, etc.).
Workflows
1. Formatting Specific Changed Files (Git Diff)
If you have made code changes locally in a git branch, the easiest way to ensure
all your changes are formatted properly is to use the -git_diff argument. This
automatically detects which files have changed compared to main and formats
them.
python3 scripts/format_code.py -git_diff
_Tip:_ You can also append -verbose for extensive logging about formatting
changes.
2. Formatting a Specific Directory
If you are working on a feature within a particular Firebase SDK (e.g.,
database), you can recursively format that entire directory:
python3 scripts/format_code.py -d database -r
To target multiple directories (e.g., both database and app):
python3 scripts/format_code.py -d database -d app -r
3. Formatting Specific Files
If you are pressed for time and only want to format specific files rather than
analyzing whole directories, use the -f flag:
python3 scripts/format_code.py -f path/to/file1.cc -f path/to/file2.h
4. Dry Run (Check without Formatting)
If you only want to detect the number of files that _need_ formatting without
actually modifying them, append the --noformat_file flag:
python3 scripts/format_code.py -git_diff --noformat_file
Other skills for the same job
different authors, same section of the catalogue
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image/font optimization, bundling
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification
How to use it
Take firebase/firebase-cpp-formatter from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference pip.
Without those the skill loads but fails at the first command.