@backstage/plugin-catalog-backend-module-ai-model

Adds support for the AiResource entity kind to the catalog backend plugin. AI resources represent contextual information consumed by AI coding tools, such as skills and rules.

Installation

Add the module to your backend:

backend.add(import('@backstage/plugin-catalog-backend-module-ai-model'));
Copy

Entity shape

apiVersion: backstage.io/v1alpha1
kind: AiResource
metadata:
  name: frontend-design
  description: Skill for creating production-grade frontend interfaces
spec:
  type: skill
  lifecycle: production
  owner: ai-platform-team
  system: ai-tooling
  disciplines:
    - web
  categories:
    - framework
  agents:
    - claude-code
  dependsOn:
    - airesource:default/base-coding-standards
Copy

The type field determines which spec fields are available. Currently supported types:

• skill — reusable contextual knowledge for AI coding tools. Supports additional fields: disciplines, categories, agents, dependsOn.
• rule — governance rules and constraints for AI coding tools. Supports additional fields: disciplines, category (required), rationale (required).

Any other type value is accepted with the base spec fields: type, lifecycle, owner, and optionally system.

Accessing skill and rule content

The actual content of skills and rules is not stored in the entity spec. Instead, the source file is referenced via the standard backstage.io/source-location annotation, consistent with how other Backstage entities reference their source files. Entity providers that generate AiResource entities from SKILL.md or rule files should set this annotation to point to the source file.