Backstage Agent Skills

Claude skills for building Backstage plugins with the New Frontend and Backend Systems.

Available Skills

backstage-frontend-plugin

Build Backstage frontend plugins with the New Frontend System (createFrontendPlugin, blueprints, routes, Utility APIs, testing). Use for creating pages, navigation items, entity content, or cards.

Includes:

• Step-by-step development workflow against the current yarn new frontend-plugin template (already NFS-wired)
• Extension blueprints guide (PageBlueprint, SubPageBlueprint, EntityContentBlueprint, ApiBlueprint, app-level blueprints) with notes on the deprecated NavItemBlueprint
• Utility API patterns (with imports from @backstage/frontend-plugin-api) and best practices
• Comprehensive testing guide with @backstage/frontend-test-utils (renderInTestApp, createExtensionTester(...).reactElement(), mockApis.*)

backstage-backend-plugin

Build Backstage backend plugins and modules with createBackendPlugin, core services, and extension points. Use for REST/HTTP APIs, background jobs, data processing, integrations, and modules that extend existing plugins.

Includes:

• Step-by-step development workflow against the current yarn new backend-plugin template (src/router.ts, express-promise-router, zod, service refs)
• Core services reference covering every coreServices.* entry (httpRouter, logger, database, httpAuth, userInfo, auth, scheduler, cache, urlReader, permissions, permissionsRegistry, auditor, lifecycle, rootHealth, …)
• Modules + extension points (createBackendModule, env.registerExtensionPoint)
• Production-ready patterns for validation, error handling (via MiddlewareFactory / root error middleware), and security
• Comprehensive testing guide with @backstage/backend-test-utils (startTestBackend + supertest, mockServices, mockCredentials, MSW v2, TestDatabases)

Installation and Usage

Each skill is a self-contained folder with:

• SKILL.md - Main skill instructions and workflow
• reference/ - Detailed reference documentation loaded on-demand

These are Agent Skills, instructions that an AI coding agent loads to do better work. They do not hook into Backstage tooling directly, so placing them in .github/ or running yarn new yourself will not use them. Instead, the agent reads the skill and then runs yarn new, converts the scaffold, and writes code following the skill’s guidance.

Claude Code

Copy a skill folder into your workspace and Claude Code discovers it automatically.

# Project-level (this workspace only)
mkdir -p .claude/skills
cp -r backstage-frontend-plugin .claude/skills/

# Or user-level (all your projects)
cp -r backstage-frontend-plugin ~/.claude/skills/