Own plugin source code: creating a new Backstage dynamic plugin for RHDH and implementing features inside an existing one. Backend and frontend are branches of the same job — the same conventions, the same build gates, the same repo — so choose the branch from the request rather than asking for a skill.
Start here
- Read the target repository's
AGENTS.mdorCLAUDE.mdand any linked specification or issue. Repository rules beat anything written here. - Run
python scripts/detect-rhdh-context.py --path <plugin-or-workspace>in an existing checkout. Record role, frontend system, plugin ID, dynamic status, MUI version, and package manager. - Establish the target RHDH and Backstage versions. Prefer an explicit user or
repository value; otherwise invoke
/rhdh-contextfor repository, tool, and version facts. If it is unavailable, ask the user instead of guessing. - Inspect branch and status before modifying files, and protect uncommitted work.
For a new plugin or a change to a public API where materially different designs
are valid and the request does not settle the choice, invoke /grilling as a
design gate, use the constraints it produces, and show the design before
implementing. If /grilling is not installed, say so, name
/setup-rhdh-skills install as the human's next step, and pause that branch.
Route by outcome
| Outcome | Load and follow |
|---|---|
| Scaffold a backend dynamic plugin | references/backend.md; run scripts/scaffold.py |
| Scaffold a frontend dynamic plugin | references/frontend.md; run scripts/scaffold.py |
| Decide what kind of extension to build | references/plugin-types.md |
| Implement or review plugin code | references/development-patterns.md, then only the relevant reference below |
| Style with Backstage UI or MUI | references/bui.md |
| Write NFS code in a new plugin | references/nfs.md |
| Apply RHDH-specific patterns | references/rhdh.md |
| Run or extend the plugin dev app | references/dev-app.md |
| Write tests for plugin code | references/testing.md |
| Write or read a frontend feature spec | references/frontend-specs.md |
Infer the branch from the request. Ask only when the missing choice changes the implementation, such as backend versus frontend.
Boundaries
- This skill writes plugin source. It does not export artifacts, generate deployment configuration, or publish anything.
/rhdh-plugin-exportowns exporting and packaging a plugin for RHDH./rhdh-plugin-wiringowns generatingdynamic-plugins.yamlconfiguration and mount points for a finished frontend plugin. Reach for it by name rather than writing wiring configuration here./rhdh-plugin-nfs-migrationowns converting an existing legacy frontend plugin to the New Frontend System. This skill writes NFS code in a plugin that is already on it./rhdh-backstage-upgradeowns moving@backstage/*dependency versions./rhdh-test-placementadvises which repository and layer a permanent test belongs in, before you write it here./rhdh-pr-createowns changesets, staging, signed-off commits, and pull requests. Leave changed files unstaged and list them when you finish.
Invoke a named skill and describe the handoff in the conversation. Never open another skill's files.
Invariants
- Backend code uses the new backend system only —
createBackendPluginorcreateBackendModulefrom@backstage/backend-plugin-api. Never the legacy backend system. - A default export from
src/index.tsis required. Its absence is the most common cause of a dynamic plugin that will not load in RHDH. - The Scalprum name must match the key used in
dynamic-plugins.yamlwiring. - Match the neighbouring implementation: check two or three sibling workspaces before inventing a configuration, fixture path, or utility pattern.
- Build incrementally. Write one component or hook, type check, and verify a visual change in a running app before writing the next.
- Mirror a current neighbouring test rather than recalling a Backstage test API from memory; that surface moves between releases.
- Run the workspace build gates in order and stop at the first failure:
yarn prettier:fix,yarn tsc:full,yarn build:all,yarn test --watchAll=false,yarn build:api-reports:only. - Do not stage, commit, push, or open a pull request here.
Completion
Report the branch taken, the files created or changed and left unstaged, the build gates run and their results, any public API surface added, the remaining risks, and the named skill to invoke next for wiring, export, testing, or publication.