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. Use when this capability is needed.

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 [e-mail]: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.

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.