idp-configurator

IDP Configurator Skill

Overview

This skill configures Internal Developer Platform (IDP) components including service catalogs, golden path templates, and self-service workflows for internal development teams.

Capabilities

• Set up Backstage service catalogs
• Configure golden path templates
• Implement self-service workflows
• Integrate with CI/CD systems
• Set up software templates
• Configure TechDocs integration
• Implement scaffolder actions
• Design developer portal UX

Target Processes

• Internal Developer Platform Setup
• Developer Portal Implementation
• SDK Architecture Design

Integration Points

• Backstage platform
• Port developer portal
• Cortex for service management
• GitHub/GitLab for templates
• CI/CD systems

Input Requirements

• Service catalog requirements
• Template requirements
• Workflow definitions
• Integration needs
• User roles and permissions

Output Artifacts

• Backstage configuration
• Software templates
• Catalog entity definitions
• TechDocs setup
• CI/CD integrations
• Custom plugins

Usage Example

skill:
  name: idp-configurator
  context:
    platform: backstage
    catalog:
      entities:
        - kind: Component
          type: service
        - kind: API
          type: openapi
    templates:
      - name: typescript-service
        path: ./templates/typescript-service
      - name: python-sdk
        path: ./templates/python-sdk
    integrations:
      github:
        enabled: true
      jenkins:
        enabled: true
    techDocs:
      builder: local

Best Practices

1. Start with golden paths for common use cases
2. Integrate service catalog with CI/CD
3. Provide self-service provisioning
4. Document everything with TechDocs
5. Track developer productivity metrics
6. Iterate based on developer feedback