backstage-development

Links

• github.com/alithya-oss/agent-plugins
• https://backstage.io
• plugins/backstage-development/plugin.json (manifest)

Skills · 20

app-frontend-system-migration

Migrate a Backstage app from the old frontend system to the new one. Use this skill when converting an app to use the new extension-based frontend system, including the hybrid migration phase and the full migration of routes, sidebar, plugins, APIs, themes, and other app-level concerns.

backstage-testing-conventions

Testing conventions for Backstage plugin development. Always run tests with CI=true to prevent interactive watch mode from blocking agents.

creating-backstage-catalog-provider

Use when building a catalog backend module that ingests entities from an external source (e.g. Azure DevOps, internal API, JSON file). Covers both the normal EntityProvider and the IncrementalEntityProvider for large-volume sources, plus module wiring via catalogProcessingExtensionPoint or incremen…

creating-backstage-entity-page-extension

Use when adding a card to a catalog entity's overview tab or a whole tab/page to a catalog entity page. Covers EntityCardBlueprint (overview-page cards) and EntityContentBlueprint (full tabs), entity filtering by kind/type/annotation, and access to the current entity via useEntity. Triggers on phra…

creating-backstage-extension-blueprint

Use when authoring a Backstage frontend plugin that wants to expose its OWN extension point, a typed "blueprint" that other plugins or modules can call to contribute to your plugin's UI. Covers createExtensionBlueprint (defining the blueprint), the parent extension that collects contributions via…

creating-backstage-plugin

Use when the user wants to create any new Backstage package, plugin, module, processor, provider, scaffolder action, or library. Drives `yarn new` to scaffold the right template and optionally pre-wires common patterns (catalog access, identity, etc.) based on user intent. Triggers on phrases like…

creating-backstage-scaffolder-action

Use when building a custom scaffolder template action, a step that scaffolder templates can call from their YAML steps. Covers createTemplateAction with Zod input/output schemas, the action handler context (logger, workspacePath, input, output, etc.), and module wiring via scaffolderActionsExtensi…

creating-backstage-scaffolder-field

Use when building a custom scaffolder form field, a React component that scaffolder template forms can use via `ui:field: <name>`. Covers FormFieldBlueprint, createFormField, the field component props (formData, onChange, schema, rawErrors, etc.), Zod-based field schema via makeFieldSchema, option…

mui-to-bui-migration

Migrate Backstage plugins from Material-UI (MUI) to Backstage UI (BUI). Use this skill when migrating components, updating imports, replacing styling patterns, or converting MUI components to their BUI equivalents.

onboard-to-openapi-server

Use this skill when the user wants to migrate an existing Backstage backend plugin's hand-written Express router to the typed OpenAPI tooling. Optionally, can also add typed client generation and migrate router tests to the OpenAPI test wrapper.

plugin-analytics-instrumentation

Instrument a Backstage frontend plugin with analytics events using the Backstage Analytics API. Use this skill when adding, reviewing, or extending event capture (`captureEvent`, `AnalyticsContext`) in plugin components, deciding whether an interaction warrants an event, or writing tests for analyt…

plugin-full-frontend-system-migration

Fully migrate a Backstage plugin to the new frontend system, dropping all old system support. Use this skill for internal plugins that only need to run in a single app, or when you are ready to remove backward compatibility entirely.

plugin-new-frontend-system-support

using-backstage-backend-services

using-backstage-backend-system

using-backstage-catalog

using-backstage-frontend-system

using-backstage-identity

using-backstage-permissions

using-backstage-ui

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

Category

DevOps & Cloud. Assigned by this directory. Agent Plugins 1.0.0 has no category field, so no manifest declares one.

Keywords

agent-plugins · backstage · backstage-plugin · frontend-system · backend-system · catalog · scaffolder · permissions · migration · openapi

Related by publisher and keywords

• adralithya-oss

  Architectural Decision Records (ADR) lifecycle skills: authoring, formats (MADR, Nygard, Y-statement, and more), decision drivers, quality, compliance auditing, and integration.

• common-architecture-language-modelalithya-oss

  FINOS Common Architecture Language Model (CALM) skills: authoring and validating architectures, nodes, relationships, interfaces, controls, flows, patterns, metadata, standards, decorators, timelines, moments, documentation, and CALM CLI usage.

• general-purpose-assistantalithya-oss

  A general purpose plugin.

• hello-worldalithya-oss

  A sample plugin to demonstrate the Agent Plugins v1.0.0 structure.

• landing-zone-accelerator-on-awsalithya-oss

  Agent skills for managing Landing Zone Accelerator on AWS (LZA) deployments via the awslabs/lza-mcp-server: configuration management, schema discovery, pipeline orchestration, and manual approvals.

• likec4-diagrammingalithya-oss

  Agent skills for LikeC4 architecture-as-code development: DSL syntax, model and views, deployment, dynamic views, predicates, CLI usage, and troubleshooting.