home / skills / a5c-ai / babysitter / developer-portal-builder

developer-portal-builder skill

safe

/plugins/babysitter/skills/babysit/process/specializations/sdk-platform-development/skills/developer-portal-builder

This skill helps you build unified developer portals that consolidate API discovery, credentials, analytics, and onboarding across Backstage or custom

npx playbooks add skill a5c-ai/babysitter --skill developer-portal-builder

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

2.1 KB

---
name: developer-portal-builder
description: Build unified developer portals with Backstage or custom frameworks
allowed-tools:
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - Bash
---

# Developer Portal Builder Skill

## Overview

This skill builds comprehensive developer portals that unify API discovery, documentation, credential management, and analytics into a single cohesive experience.

## Capabilities

- Configure service catalog and API discovery
- Implement credential management UI (API keys, OAuth apps)
- Build API discovery and search features
- Integrate analytics and usage dashboards
- Configure self-service onboarding flows
- Implement rate limit and quota visualization
- Build webhook management interfaces
- Support multi-tenant portal configurations

## Target Processes

- Developer Portal Implementation
- Internal Developer Platform Setup
- Developer Experience Optimization

## Integration Points

- Backstage for internal platforms
- Port for developer portals
- Custom React/Next.js applications
- Stripe-style portal patterns
- API management platforms (Kong, Apigee)

## Input Requirements

- API catalog requirements
- Authentication/authorization model
- Credential types to manage
- Analytics requirements
- Branding and UX guidelines
- Multi-tenancy requirements

## Output Artifacts

- Developer portal application
- Service catalog configuration
- Credential management system
- Analytics dashboard
- Onboarding flow implementation
- Documentation integration
- Admin panel for portal management

## Usage Example

```yaml
skill:
  name: developer-portal-builder
  context:
    framework: backstage
    features:
      - apiCatalog
      - credentialManagement
      - usageDashboard
      - webhookManagement
    authProvider: auth0
    multiTenant: false
    customBranding: true
```

## Best Practices

1. Prioritize time-to-first-call metrics
2. Implement self-service credential management
3. Provide clear usage and billing visibility
4. Enable easy environment switching
5. Include comprehensive search functionality
6. Support team and organization management

Overview

This skill builds unified developer portals that centralize API discovery, credential management, onboarding, and analytics into a single experience. It supports Backstage or custom React/Next.js frameworks and can be tailored for multi-tenant or single-tenant environments. The outcome is a developer-focused portal that reduces time-to-first-call and improves internal developer platform consistency.

How this skill works

The skill inspects API catalog requirements, authentication and authorization models, credential types, analytics needs, branding guidelines, and tenancy constraints. It generates a portal application, service catalog configuration, credential management UI, usage dashboards, onboarding flows, and admin panels. Integrations with Backstage, API management platforms, and custom frontends are implemented as adapters or plugins.

When to use it

Building or modernizing an internal developer portal or internal developer platform (IDP).
Unifying API discovery, documentation, and credentials across teams.
Rolling out self-service onboarding and credential issuance for external or internal developers.
Implementing usage and billing visibility tied to APIs and developer teams.
Migrating to Backstage or creating a custom branded portal for multiple tenants.

Best practices

Design for time-to-first-call: make API discovery and sample code visible immediately.
Provide self-service credential issuance and clear rotation workflows.
Expose usage, rate limits, and quota visuals tied to developer identity and teams.
Support environment switching (dev/staging/prod) and clear context markers.
Implement robust search across APIs, docs, and onboarding steps for rapid discovery.

Example use cases

Create a Backstage-based portal with a searchable API catalog, onboarding flow, and usage dashboard.
Add credential management UI (API keys, OAuth apps) and automated rotation for internal services.
Implement multi-tenant portals with per-tenant branding, quotas, and admin panels.
Integrate analytics from API gateways (Kong, Apigee) into per-service usage dashboards.
Build webhook management interfaces and developer-facing testing sandboxes.

FAQ

Which frameworks does this skill support?

Backstage is a primary target, but it also supports custom React or Next.js portals and integrations with common API gateways.

What inputs are required to start a portal project?

Provide the API catalog schema, auth model, credential types, analytics needs, branding guidelines, and any multi-tenancy rules.