# Giantswarm Backstage Backstage Backend Plugin

> Backstage Backend Plugin (New Backend System)

- Skill: `tomevault-io/giantswarm-backstage-backstage-backend-plugin` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/giantswarm-backstage-backstage-backend-plugin`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/giantswarm-backstage-backstage-backend-plugin/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/giantswarm-backstage-backstage-backend-plugin

---


# 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:

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

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

```bash
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](https://tomevault.io/claim/giantswarm) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->