Skip to content

SkillMeat Backstage Integration

SkillMeat integrates with Backstage through two complementary plugins, enabling your development platform to discover, browse, validate, and deploy SkillMeat artifacts directly within your IDP. This integration brings artifact governance and AI context management into the developer self-service experience.

What This Integration Enables

SkillMeat's Backstage integration transforms Backstage into an artifact discovery and deployment hub:

  • Unified Artifact Catalog — Browse all available SkillMeat artifacts (skills, commands, agents, workflows) within Backstage's entity catalog
  • Developer Self-Service — Scaffold new projects with pre-loaded AI context packs, automation workflows, and skill bundles using Backstage templates
  • Deployment Context Visibility — View artifact deployment status, version tracking, and drift detection directly in entity pages
  • Governance at the IDP Layer — Apply organization policies, version enforcement, and compliance checks to artifact adoption
  • Telemetry & Analytics — Track workflow effectiveness, project health, and platform metrics across your IDP

Walkthrough available

See the Backstage Platform Engineer Walkthrough for a complete integration journey from installation through governance.

Who This Is For

This section is designed for platform engineers and enterprise administrators who are:

  • Running Backstage as your Internal Developer Platform (IDP)
  • Adopting SkillMeat for centralized artifact management across teams
  • Provisioning self-service artifact deployment capabilities to developers
  • Implementing governance and compliance controls over artifact usage

High-Level Capabilities

1. Artifact Browser & Catalog Integration

Browse SkillMeat artifacts directly in Backstage's catalog. The plugin surfaces artifact metadata, version history, and availability status within your existing entity provider infrastructure. See Plugin Installation & Configuration for setup details.

2. Catalog Integration & Entity Provider

Connect SkillMeat's artifact repository as an entity provider in Backstage's catalog system. Automatically sync artifact metadata, ownership, and governance state. See Catalog Integration Guide for configuration.

3. Developer Portal Surface

Embed artifact browsing, scaffolding templates, and deployment workflows directly in your developer portal. Developers discover and adopt SkillMeat artifacts as part of their normal IDP workflow. See Developer Portal Integration.

4. Governance & Permissions

Define organizational policies for artifact adoption, enforce version constraints, and audit artifact deployments through Backstage's RBAC and governance layers. See Governance & Permissions Guide.

Prerequisites

Before integrating SkillMeat with Backstage, ensure you have:

  • Backstage v1.27.x or later (tested compatibility; RHDH 1.3+ also supported)
  • SkillMeat API v1.0.0+ deployed and reachable from your Backstage instance
  • Admin or Platform Engineer access to your Backstage app configuration
  • Network connectivity between Backstage and SkillMeat API (typically internal network or configured proxy)
  • SkillMeat API authentication — bearer token or service account credentials (see individual guides for setup)

Architecture Overview

The integration uses two plugins working together:

Plugin Purpose Used By
@skillmeat/backstage-plugin Frontend plugin providing artifact browsing UI, entity cards, and telemetry dashboards Entity pages, developer portal surfaces
@skillmeat/backstage-plugin-scaffolder-backend Backend scaffolder actions for template-driven deployment and context injection Backstage scaffolder templates

Together, they enable a complete artifact lifecycle within Backstage: discover → scaffold → deploy → govern → monitor.

Next Steps

Choose the guide that matches your integration goal:

Getting Started with the Plugin

Start here if you're installing SkillMeat plugins in Backstage for the first time.

→ Plugin Installation & Configuration

Connecting Your Artifact Repository

Set up artifact catalog integration to expose SkillMeat artifacts in Backstage's entity catalog.

→ Catalog Integration Guide

Surfacing Artifacts to Developers

Configure your developer portal to show artifact browsing, discovery, and adoption workflows.

→ Developer Portal Integration

Implementing Governance & Controls

Define policies, permissions, and compliance rules for artifact adoption in your organization.

→ Governance & Permissions Guide

Troubleshooting

If you encounter issues during integration, refer to the troubleshooting section in the relevant sub-guide:

API Reference

For detailed API behavior and integration specifics, see the plugin README files:

Support & Feedback

For issues, questions, or feature requests related to the Backstage integration, please reach out to your platform engineering team or file an issue on the SkillMeat repository.