From db7b6d17163556d08948500a2620ce2969869b62 Mon Sep 17 00:00:00 2001 From: Patrik Oldsberg Date: Wed, 25 Mar 2026 10:08:21 +0100 Subject: [PATCH] docs: refine skill descriptions Signed-off-by: Patrik Oldsberg Made-with: Cursor --- docs/.well-known/skills/app-frontend-system-migration/SKILL.md | 2 +- .../skills/plugin-full-frontend-system-migration/SKILL.md | 2 +- .../skills/plugin-new-frontend-system-support/SKILL.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/.well-known/skills/app-frontend-system-migration/SKILL.md b/docs/.well-known/skills/app-frontend-system-migration/SKILL.md index a7a43ef515..0bfbf0714c 100644 --- a/docs/.well-known/skills/app-frontend-system-migration/SKILL.md +++ b/docs/.well-known/skills/app-frontend-system-migration/SKILL.md @@ -1,6 +1,6 @@ --- name: app-frontend-system-migration -description: Migrate a Backstage app from the old frontend system to the new extension-based frontend system. Use this skill when migrating packages/app from app-defaults to frontend-defaults, converting routes, sidebar, plugins, and other app-level configuration. +description: Migrate a Backstage app from the old frontend system to the new one. Use this skill when converting an app to use the new extension-based frontend system, including the hybrid migration phase and the full migration of routes, sidebar, plugins, APIs, themes, and other app-level concerns. --- # App Frontend System Migration Skill diff --git a/docs/.well-known/skills/plugin-full-frontend-system-migration/SKILL.md b/docs/.well-known/skills/plugin-full-frontend-system-migration/SKILL.md index 14f2f1d6a0..6afd950bfe 100644 --- a/docs/.well-known/skills/plugin-full-frontend-system-migration/SKILL.md +++ b/docs/.well-known/skills/plugin-full-frontend-system-migration/SKILL.md @@ -1,6 +1,6 @@ --- name: plugin-full-frontend-system-migration -description: Fully migrate an existing Backstage plugin to the new frontend system, removing all old system dependencies. Use this skill when converting a plugin to exclusively use @backstage/frontend-plugin-api, replacing internal routing with PageBlueprint/SubPageBlueprint, adopting Backstage UI headers and page layout, and removing @backstage/core-plugin-api usage. +description: Fully migrate a Backstage plugin to the new frontend system, dropping all old system support. Use this skill for internal plugins that only need to run in a single app, or when you are ready to remove backward compatibility entirely. --- # Full Plugin Migration to the New Frontend System diff --git a/docs/.well-known/skills/plugin-new-frontend-system-support/SKILL.md b/docs/.well-known/skills/plugin-new-frontend-system-support/SKILL.md index c78c3bbfbf..b980984ff8 100644 --- a/docs/.well-known/skills/plugin-new-frontend-system-support/SKILL.md +++ b/docs/.well-known/skills/plugin-new-frontend-system-support/SKILL.md @@ -1,6 +1,6 @@ --- name: plugin-new-frontend-system-support -description: Add new frontend system support to an existing Backstage plugin while maintaining backward compatibility with the old system. Use this skill when adding an alpha entry point, creating PageBlueprint/SubPageBlueprint extensions, and implementing the dual-header pattern (old Header vs new HeaderPage/PluginHeader). +description: Add new frontend system support to an existing Backstage plugin while keeping the old system working. Use this skill for published or shared plugins that need to work in both old and new frontend system apps. --- # Adding New Frontend System Support to an Existing Plugin