feat(go): add middleware reference to Genkit Go skill

skills/developing-genkit-go/SKILL.md

@@ -18,10 +18,10 @@ import (
 	"log"
 	"net/http"
 
-	"github.com/genkit-ai/genkit/go/ai"
-	"github.com/genkit-ai/genkit/go/genkit"
-	"github.com/genkit-ai/genkit/go/plugins/googlegenai"
-	"github.com/genkit-ai/genkit/go/plugins/server"
+	"github.com/firebase/genkit/go/ai"
+	"github.com/firebase/genkit/go/genkit"
+	"github.com/firebase/genkit/go/plugins/googlegenai"
+	"github.com/firebase/genkit/go/plugins/server"
 )
 
 func main() {
@@ -53,6 +53,7 @@ Load the appropriate reference based on what you need:
 | Generation | [references/generation.md](references/generation.md) | `Generate`, `GenerateText`, `GenerateData`, streaming, output formats |
 | Prompts | [references/prompts.md](references/prompts.md) | `DefinePrompt`, `DefineDataPrompt`, `.prompt` files, schemas |
 | Tools | [references/tools.md](references/tools.md) | `DefineTool`, tool interrupts, `RestartWith`/`RespondWith` |
+| Middleware | [references/middleware.md](references/middleware.md) | `ai.Middleware`, `ai.WithUse`, `Hooks` (Generate/Model/Tool), built-ins (`Retry`, `Fallback`, `ToolApproval`, `Filesystem`, `Skills`) |
 | Flows & HTTP | [references/flows-and-http.md](references/flows-and-http.md) | `DefineFlow`, `DefineStreamingFlow`, `genkit.Handler`, HTTP serving |
 | Model Providers | [references/providers.md](references/providers.md) | Google AI, Vertex AI, Anthropic, OpenAI-compatible, Ollama setup |
 
@@ -92,4 +93,5 @@ See [references/getting-started.md](references/getting-started.md) for full CLI
 - **Use `jsonschema:"description=..."` struct tags on output types.** The model uses these descriptions to understand what each field should contain. Without them, structured output quality drops significantly.
 - **Write good tool descriptions.** The model decides which tools to call based on their description string. Vague descriptions lead to missed or incorrect tool calls.
 - **Use `.prompt` files for complex prompts.** They separate prompt content from Go code, support Handlebars templating, and can be iterated on without recompilation. Code-defined prompts are better for simple, single-line cases.
+- **Reach for built-in middleware before writing one.** `Retry`, `Fallback`, `ToolApproval`, `Filesystem`, and `Skills` cover the common cross-cutting needs and compose with each other via `ai.WithUse`. See [references/middleware.md](references/middleware.md). When you do write custom middleware, allocate per-call state in closures captured by `New`, and guard anything that `WrapTool` mutates because tools may run concurrently.
 - **Look up the latest model IDs.** Model names change frequently. Check provider documentation for current model IDs rather than relying on hardcoded names. See [references/providers.md](references/providers.md).

skills/developing-genkit-go/references/getting-started.md

@@ -5,15 +5,15 @@
 ```bash
 mkdir my-genkit-app && cd my-genkit-app
 go mod init my-genkit-app
-go get github.com/genkit-ai/genkit/go@latest
+go get github.com/firebase/genkit/go@latest
 ```
 
 Add provider plugin(s) for the models you want to use:
 ```bash
-go get github.com/genkit-ai/genkit/go/plugins/googlegenai  # Google AI / Vertex AI
-go get github.com/genkit-ai/genkit/go/plugins/anthropic     # Anthropic Claude
-go get github.com/genkit-ai/genkit/go/plugins/compat_oai    # OpenAI-compatible
-go get github.com/genkit-ai/genkit/go/plugins/ollama        # Ollama (local)
+go get github.com/firebase/genkit/go/plugins/googlegenai  # Google AI / Vertex AI
+go get github.com/firebase/genkit/go/plugins/anthropic     # Anthropic Claude
+go get github.com/firebase/genkit/go/plugins/compat_oai    # OpenAI-compatible
+go get github.com/firebase/genkit/go/plugins/ollama        # Ollama (local)
 ```
 
 After writing your code, run `go mod tidy` to resolve all dependencies.
@@ -25,8 +25,8 @@ Every Genkit app starts with `genkit.Init`, which returns a `*Genkit` instance:
 ```go
 import (
 	"context"
-	"github.com/genkit-ai/genkit/go/genkit"
-	"github.com/genkit-ai/genkit/go/plugins/googlegenai"
+	"github.com/firebase/genkit/go/genkit"
+	"github.com/firebase/genkit/go/plugins/googlegenai"
 )
 
 ctx := context.Background()
@@ -134,9 +134,9 @@ GENKIT_ENV=dev go run .
 
 ```go
 import (
-	"github.com/genkit-ai/genkit/go/genkit"          // Core: Init, Generate*, DefineFlow, etc.
-	"github.com/genkit-ai/genkit/go/ai"              // Types: WithModel, WithPrompt, Message, Part, etc.
-	"github.com/genkit-ai/genkit/go/core"            // Low-level: Run (sub-steps), Flow types
-	"github.com/genkit-ai/genkit/go/plugins/server"  // server.Start for HTTP
+	"github.com/firebase/genkit/go/genkit"          // Core: Init, Generate*, DefineFlow, etc.
+	"github.com/firebase/genkit/go/ai"              // Types: WithModel, WithPrompt, Message, Part, etc.
+	"github.com/firebase/genkit/go/core"            // Low-level: Run (sub-steps), Flow types
+	"github.com/firebase/genkit/go/plugins/server"  // server.Start for HTTP
 )
 ```