Claude Skills by microbus-io

TRIGGER when user asks to add or modify a configuration property or setting, or to make a value configurable. Affects intermediate.go, manifest.yaml. Do NOT manually define configs - this skill wires up getter, setter, and validation.

TRIGGER when user asks to add, create, or modify an API endpoint, function, or RPC. Also when adding a route that accepts typed arguments and returns typed results. Affects intermediate.go, *api/client.go, mock.go, manifest.yaml.

TRIGGER when user asks to listen for, subscribe to, or handle an event from another microservice. Wires up the event sink handler. Affects intermediate.go, mock.go, manifest.yaml.

TRIGGER when user asks to add or modify a metric, counter, gauge, or histogram, or to track/measure an operation. Affects intermediate.go, manifest.yaml. Do NOT manually define metrics - this skill wires up recorders and OpenTelemetry names.

TRIGGER when user asks to create, scaffold, or initialize a new microservice. Creates the full directory structure including service.go, intermediate.go, client.go, mock.go, manifest.yaml, and test scaffolding.

TRIGGER when user asks to fire, emit, or publish an event that other services can subscribe to. Creates event trigger and hook in *api/client.go. Affects intermediate.go, manifest.yaml.

TRIGGER when user asks to add a workflow step, task endpoint, or workflow phase. Tasks are handlers that read/write shared state via workflow.Flow. Affects intermediate.go, *api/client.go, mock.go, manifest.yaml.

TRIGGER when user asks to add a recurring job, periodic task, scheduled operation, or ticker. Affects intermediate.go, mock.go, manifest.yaml. Do NOT manually wire up tickers.

TRIGGER when user asks to add or modify a web handler, HTML page, file download, or raw HTTP endpoint. Use for endpoints that work with http.ResponseWriter/http.Request. Affects intermediate.go, *api/client.go, mock.go, manifest.yaml.

TRIGGER when user asks to define a workflow graph, orchestrate tasks, or create a multi-step agentic workflow. Defines task transitions and conditions. Affects intermediate.go, *api/client.go, mock.go, manifest.yaml.

Run after completing any change to a microservice. Vets compilation, updates manifest.yaml, documentation, version, and topology diagram. Skip if the skill you just followed already includes housekeeping as a final step.

TRIGGER when the user asks to delegate to or integrate an external/third-party REST API, import an OpenAPI/Swagger document, or generate a microservice from an OpenAPI spec (by URL or pasted JSON/YAML). Produces a one-for-one delegating microservice and stores openapispecs.json in its directory so more endpoints can be imported later.

TRIGGER when user asks to initialize, set up, or bootstrap a Microbus project. Creates main/main.go, config files, agent files, .gitignore, VS Code launch config, and authentication scaffolding.

TRIGGER when user asks to change the signature, route, method, arguments, or return type of an existing endpoint, config, metric, or ticker. Coordinates changes across service.go, intermediate.go, client.go, mock.go, and manifest.yaml.

Regenerates the boilerplate files of a microservice from its manifest and service code. Use when boilerplate files are corrupted, outdated, or need to be rebuilt from scratch.

TRIGGER when user asks to remove, delete, or drop an endpoint, config, metric, ticker, or event from a microservice. Safely removes code from service.go, intermediate.go, client.go, mock.go, service_test.go, and manifest.yaml.

Performs an architectural review of a microservice-based system built on the Microbus framework. Examines service boundaries, dependencies, coupling, API design, resilience, data ownership, observability, security, and operational concerns. Produces a structured report with findings and recommendations.

Performs a thorough review of a single Microbus microservice. Checks for completeness, framework compliance, code quality, security, test coverage, documentation, API design, and data access performance. Produces a structured report with findings and recommendations.

Runs the agent-guided tour of Microbus using examples. Use when the user asks to take the tour.

TRIGGER when user asks to externalize, internationalize, or translate user-facing strings. Moves hardcoded display text into a text.yaml resource bundle for i18n support.

TRIGGER when user asks to add a Python-backed function endpoint to an existing Python-backed microservice. The Go side is a normal Microbus function endpoint; the body delegates to a Python function via svc.venv.CallAndAwait. Affects intermediate.go, *api/endpoints.go, *api/client.go, mock.go, service.py, manifest.yaml.

TRIGGER when user asks to create a microservice that calls Python, runs ML inference, uses PyTorch/pandas/sentence-transformers/numpy, or otherwise needs Python libraries for its core compute. Scaffolds a Microbus microservice that owns its own in-process Python virtual environment via github.com/microbus-io/pyvenv, with manual-subscription lifecycle, an embedded Python source tree, and a pip requirements file.

TRIGGER when user asks to add a Python-backed workflow task to an existing Python-backed microservice. The Go side is a normal Microbus workflow task endpoint on :428; the body uses svc.venv.Call + Await with the callID persisted in flow state so a long-running Python call survives task retries across the framework's 15-minute hop ceiling. Affects intermediate.go, *api/endpoints.go, *api/client.go, mock.go, service.py, manifest.yaml.

TRIGGER when user asks to add fields, properties, or columns to a SQL CRUD microservice's object. Affects the struct, SQL migration, column mapping, query filter, validation, and tests.

TRIGGER when user asks to create a CRUD microservice, database-backed service, or a service to persist/store objects in SQL (MySQL, Postgres, MSSQL). Scaffolds full CRUD with REST endpoints, schema migrations, and query filtering.

TRIGGER when user asks to change, rename, or retype fields, properties, or columns of a SQL CRUD microservice's object. Affects the struct, SQL migration, column mapping, query filter, validation, and tests.

TRIGGER when user asks to remove, drop, or delete fields, properties, or columns from a SQL CRUD microservice's object. Affects the struct, SQL migration, column mapping, query filter, validation, and tests.

TRIGGER when user asks to rename the object type or struct used by a SQL CRUD microservice. Renames across the API package, service code, and tests.

TRIGGER when user asks to rename the database table used by a SQL CRUD microservice. Creates a SQL migration and updates all table references.

TRIGGER when user asks to upgrade the project to the latest version of Microbus, or to update the framework. Orchestrates version-specific upgrade skills in sequence.

Called by upgrade-v1-22-0. Upgrades a single microservice to v1.22.0.

Called by upgrade-microbus. Upgrades the project and all microservices to v1.22.0.

Called by upgrade-v1-23-0. Upgrades a single microservice to v1.23.0.

Called by upgrade-microbus. Upgrades the project and all microservices to v1.23.0.

Called by upgrade-microbus. Upgrades the project to v1.24.0.

Called by upgrade-microbus. Upgrades the project to v1.25.0.

Called by upgrade-microbus. Upgrades the project to v1.26.0. Adds workflow scaffolding, task/graph HINTs, workflow import guards, and SQLite variants to SQL migrations.

Called by upgrade-microbus. Upgrades the project from v1.26.x to the current latest layout. Replaces svc.Subscribe(...) calls in intermediate.go with svc.Subscribe("Name", handler, sub.Method/Route/Description/<Feature>), drops the per-service doOpenAPI handler (the connector now serves :0/openapi.json built-in), drops Test*_OpenAPI tests, and migrates LLM tool callers to the []string URL contract.

Called by upgrade-microbus. Upgrades the project to v1.27.1. Splits each microservice's `*api/client.go` into `client.go` + `endpoints.go`, moving the `Hostname` constant, the `Def` type and `URL()` method, the `var (...)` block of `Def{...}` literals, and every `*In`/`*Out` struct into `endpoints.go`.

Called by upgrade-microbus. Upgrades the project to v1.28.0. Renames each microservice's `AGENTS.md` to `CLAUDE.md`, replacing the old redirect-only `CLAUDE.md`.

Called by upgrade-microbus. Upgrades the project from v1.28.x to v1.29.0. Flags reserved `id-`/`loc-` hostnames, removes redundant `iss=~"access.token.core"` predicates, drops the `microbus:"1"` bearer-token escape hatch, and regenerates manifests + topology with the new `cmd/genmanifest` and `cmd/gentopology` tools.

Called by upgrade-microbus. Upgrades the project from v1.29.x to v1.30.0. Renames graph error/timeout transitions, switches workflow graphs to named nodes with explicit SetFanIn, replaces sub.Infra/Ultra with sub.Manual/Automatic (semantics changed), renames Subscription.Route to Path, changes the httpingress AllowedOrigins default, and regenerates every mock with the new cmd/genmock tool.

Called by upgrade-microbus. Upgrades the project from v1.31.x to v1.32.0. Deletes the removed workflow.Graph.SetTimeBudget (per-task time budgets are now declared on the task endpoint via the new sub.TimeBudget option), renames the foreman DefaultTimeBudget config to TimeBudget, adds a trailing *workflow.FlowOptions argument to foreman Create and Run (priority/fairness), and regenerates manifests and mocks (which now carry a "DO NOT EDIT" marker).

Called by upgrade-microbus. Upgrades the project from v1.34.x to v1.35.0. Removes the Microbus clock-shift mechanism (svc.Now, frame.ClockShift family, Microbus-Clock-Shift header), introduces the workflow.FlowOutcome return shape for Snapshot/Await/Run and the OnFlowStopped event payload, moves the flow status constants from foremanapi to the workflow package (foremanapi.StatusCompleted -> workflow.StatusCompleted, etc.), adds a reason argument to foremanapi.Cancel, adds a trailing *workflow...

Called by upgrade-microbus. Upgrades the project from v1.35.x to v1.36.0. Removes graph.DeclareInputs / graph.DeclareOutputs and workflow.FilterState (subgraph boundaries are now pass-through). Workflow authors who need narrower contracts at a subgraph boundary bracket the subgraph with Before<NodeName> / After<NodeName> adapter tasks using the new flow.Delete / flow.Clear / flow.Keep / flow.Transform primitives (see .claude/rules/workflows.txt for the convention).