Skill Detail

Backstage Software Catalog Sync

Synchronizes service metadata into Spotify Backstage catalog using catalog-info.yaml generation and the Backstage Catalog REST API. Manages component, API, and system entity relationships across teams.

Templates & WorkflowsCursor
Templates & Workflows Cursor Security Reviewed
Tool match: gitlab โญ 33.1k GitHub stars
INSTALL WITH ANY AGENT
npx skills add agentskillexchange/skills --skill backstage-software-catalog-sync Copy
Works best when you want a reusable capability, not another fragile one-off prompt.
At a glance
Author
Backstage
Last updated
Mar 24, 2026
Quick brief

The Backstage Software Catalog Sync skill automates the population and maintenance of a Spotify Backstage developer portal software catalog. It discovers services across GitHub organizations, GitLab groups, and Bitbucket projects, generating catalog-info.yaml descriptor files with proper Component, API, System, and Domain entity definitions. The skill maps repository metadata, CI/CD pipeline configurations, and deployment targets into Backstage entity relationships including ownedBy, consumesApi, providesApi, and partOf hierarchies. Team ownership is resolved from CODEOWNERS files and organization membership APIs. The Backstage Catalog REST API is used for bulk entity registration, relationship validation, and orphaned entity cleanup. Tech Docs integration generates MkDocs sites from repository documentation and publishes them to the configured storage backend. The skill maintains entity annotations for monitoring dashboards, runbook links, and on-call schedule references, creating a comprehensive service directory that reduces cognitive load for developers navigating complex microservice architectures.