add firebase-functions-basics by jhuleatt · Pull Request #15 · firebase/agent-skills

jhuleatt · 2026-02-20T16:06:49Z

Add skills for Cloud Functions for Firebase

Fixes #9

skills/firebase-cloud-functions/SKILL.md

inlined · 2026-02-24T00:59:05Z

I have an entirely different skill on migrating from configs to params. Maybe we should not even mention config except as instructions to always use params instead? Can you ping me tomorrow about this?

jhuleatt · 2026-02-24T18:37:08Z

I have an entirely different skill on migrating from configs to params. Maybe we should not even mention config except as instructions to always use params instead? Can you ping me tomorrow about this?

@inlined, in the interest of getting this out in the hands of developers, want to either (1) keep upgrade.md for now, and then overwrite it with your own PR or update it to reference a new separate skill, or (2) delete upgrade.md and merge the rest of the skill?

skills/firebase-functions-basics/SKILL.md

skills/firebase-cloud-functions/SKILL.md

jhuleatt · 2026-02-25T21:11:30Z

@inlined I've removed upgrade.md and all references to functions.config, and renamed the skill to firebase-functions-basic. LGTY?

egilmorez

Some thoughts for you Jeff, thanks!

egilmorez · 2026-02-26T21:24:18Z

skills/firebase-functions-basics/references/node_setup.md

@@ -0,0 +1,69 @@
+# Cloud Functions for Firebase setup guide
+
+This guide provides a step-by-step process for setting up Cloud Functions, tailored for coding agents.


Should we specify "with the Node.js runtime," and also add a "(Node.js)" to the title line?

egilmorez · 2026-02-26T21:25:49Z

skills/firebase-functions-basics/references/node_setup.md

+
+## 1. Create a 2nd-gen HTTP function
+
+Replace the contents of `src/index.ts` (or `index.js`) with the following code to create a simple, modern v2 HTTP endpoint.


I like the clarification below in the Python page: "along with a Firestore-triggered function."

egilmorez · 2026-02-26T21:28:19Z

skills/firebase-functions-basics/SKILL.md

+This section only applies to Node.js, since all Python functions are 2nd gen.
+
+- Always use 2nd-gen functions for new development. They are powered by Cloud Run and offer better performance and configurability.
+- Use 1st-gen functions *only* for Analytics and basic Auth triggers, since those aren't supported by 2nd gen.


Auth triggers are on the near horizon, right? Is there a way to comment or flag this for update when we get them?

egilmorez · 2026-02-26T21:30:35Z

skills/firebase-functions-basics/SKILL.md

+
+Functions can be initialized using the CLI or manually. Ensure you have initialized the Firebase Admin SDK to interact with other Firebase services.
+
+1.  Install the Admin SDK:


Is this Node.js-specific? If so, it probably belongs in the lower-level references file.

I'm no coding genius, but I'm thinking this file is leaning Node and possibly neglecting Python and other runtimes-to-be. If we can make it language agnostic, that would be a win I think.

This may be redundant with what's in the node setup. We're also being inconsistent with initializeApp. I like using it in onInit tbh

egilmorez · 2026-02-26T21:31:46Z

skills/firebase-functions-basics/references/node_setup.md

+- Use `defineString`, `defineInt`, `defineSecret` for environment configuration.
+- Recommend a `maxInstances` setting of 1 for all functions until correct behavior can be verified.
+
+## 2. Build TypeScript


Are we missing a dependencies step? Or do we assume they installed with Node.js dependencies?

Should we mention that building isn't necessary before deploying?

inlined

Should we teach the model that --functions is used when only emulating functions? A lot of functions depend on event sources and I almost never run only --functions.

We might also want to add the genkit UI in the npx concurrently call

inlined · 2026-02-27T17:06:38Z

skills/firebase-functions-basics/references/node_setup.md

+const scaleLimit = defineInt("MAX_INSTANCES", { default: 1 });
+const greeting = defineString("GREETING", { default: "Hello" });
+
+export const helloWorld = onRequest({ maxInstances: scaleLimit }, async (request, response) => {


nit: If you're going to use scaleLimit repeatedly, should it be in setGlobalOptions?

inlined · 2026-02-27T19:00:11Z

skills/firebase-functions-basics/references/node_setup.md

+- Use `defineString`, `defineInt`, `defineSecret` for environment configuration.
+- Recommend a `maxInstances` setting of 1 for all functions until correct behavior can be verified.
+
+## 2. Build TypeScript


Should we mention that building isn't necessary before deploying?

inlined · 2026-02-27T19:11:52Z

skills/firebase-functions-basics/references/node_setup.md

+
+```bash
+# Start the functions emulator
+firebase emulators:start --only functions


Should we expand this to say you should be running tsc --watch concurrently if running typescript?

TIL you can run:

npx concurrently "tsc --watch" "firebase emulators:start"

We should even consider making this the dev script?

inlined · 2026-02-27T19:13:23Z

skills/firebase-functions-basics/references/node_setup.md

@@ -0,0 +1,69 @@
+# Cloud Functions for Firebase setup guide


The thing people hate about params is that they can't use it at global scope. I wonder if we should update the skill to show a use of onInit?

inlined · 2026-02-27T19:18:37Z

skills/firebase-functions-basics/SKILL.md

+This section only applies to Node.js, since all Python functions are 2nd gen.
+
+- Always use 2nd-gen functions for new development. They are powered by Cloud Run and offer better performance and configurability.
+- Use 1st-gen functions *only* for Analytics and basic Auth triggers, since those aren't supported by 2nd gen.


I might modify this. Maybe "discourage analytics functions because they will not be supported in 2nd gen." and something around the idea that auth functions may not be released yet, use them if they are but use 1st gen otherwise. They are coming imminently (though they have been for ages).

inlined · 2026-02-27T19:24:32Z

skills/firebase-functions-basics/SKILL.md

+
+Functions can be initialized using the CLI or manually. Ensure you have initialized the Firebase Admin SDK to interact with other Firebase services.
+
+1.  Install the Admin SDK:


This may be redundant with what's in the node setup. We're also being inconsistent with initializeApp. I like using it in onInit tbh

add a CF3 skill

496ed2b

lahirumaramba reviewed Feb 23, 2026

View reviewed changes

skills/firebase-cloud-functions/SKILL.md Outdated Show resolved Hide resolved

jhuleatt added 2 commits February 24, 2026 13:33

use modular Admin SDK import

f65ab01

change upgrade instructions to use new defineJsonSecret flow

0075f47

jhuleatt added 2 commits February 24, 2026 16:25

rename to cloud-functions-basics

628dd86

rename to firebase-functions-basics

5b0dab9

joehan reviewed Feb 25, 2026

View reviewed changes

skills/firebase-functions-basics/SKILL.md Show resolved Hide resolved

skills/firebase-cloud-functions/SKILL.md Outdated Show resolved Hide resolved

remove upgrade guide and all references to functions.config

addcf4c

jhuleatt requested review from egilmorez, joehan and lahirumaramba February 26, 2026 14:46

jhuleatt changed the title ~~Add Cloud Functions for Firebase~~ add firebase-functions-basics Feb 26, 2026

egilmorez reviewed Feb 26, 2026

View reviewed changes

inlined reviewed Feb 28, 2026

View reviewed changes

		@@ -0,0 +1,69 @@
		# Cloud Functions for Firebase setup guide

		This guide provides a step-by-step process for setting up Cloud Functions, tailored for coding agents.


		## 1. Create a 2nd-gen HTTP function

		Replace the contents of `src/index.ts` (or `index.js`) with the following code to create a simple, modern v2 HTTP endpoint.


		Functions can be initialized using the CLI or manually. Ensure you have initialized the Firebase Admin SDK to interact with other Firebase services.

		1. Install the Admin SDK:

Conversation

jhuleatt commented Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

inlined commented Feb 24, 2026

Uh oh!

jhuleatt commented Feb 24, 2026

Uh oh!

Uh oh!

Uh oh!

jhuleatt commented Feb 25, 2026

Uh oh!

egilmorez left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

inlined left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

jhuleatt commented Feb 20, 2026 •

edited

Loading