backstage-backend-plugin

name: backstage-backend-plugin description: 'Build Backstage backend plugins with createBackendPlugin and core services: DI, httpRouter, secure-by-default auth, Knex DB, routes, testing. Use for APIs and background jobs.' version: 1.0.0 allowed-tools: Bash, Read, Write, Edit, Glob, Grep

Backstage Backend Plugin (New Backend System)

Context

• Skills repo dir: !echo $BACKSTAGE_AGENT_SKILLS_DIR

Instructions

Check the context above. If the skills repo dir is not empty, follow the Full Mode instructions. Otherwise, STOP and follow the Setup Required instructions.

Full Mode (skills repo available)

The full skill with detailed reference documentation is available externally.

1. Read the full SKILL.md from the external repo:

   Read file: ${BACKSTAGE_AGENT_SKILLS_DIR}/backstage-backend-plugin/SKILL.md

2. Follow all instructions in that file exactly as written.

3. Resolve reference links against the external repo directory. When the external SKILL.md references ./reference/core_services.md or ./reference/testing.md, read them from:

   ${BACKSTAGE_AGENT_SKILLS_DIR}/backstage-backend-plugin/reference/<filename>

4. Use the local cleanup script from this project (not the external one):

   node .claude/skills/backstage-backend-plugin/scripts/cleanup-scaffolding-backend.js <plugin-path>

Setup Required (skills repo not available)

STOP. Do not attempt to build a backend plugin without the skills repo.

The BACKSTAGE_AGENT_SKILLS_DIR environment variable is not configured. This skill requires the external reference documentation to work correctly.

Tell the user:

To use this skill, clone the skills repo and set the environment variable:

git clone git@github.com:rothenbergt/backstage-agent-skills.git

Then add to your ~/.zshrc or ~/.bashrc:

export BACKSTAGE_AGENT_SKILLS_DIR="/path/to/backstage-agent-skills"

Restart your shell (or run source ~/.zshrc) and try again.