platform-product-manager

Expert platform and API product management guidance for developer-focused products. Use when planning API product strategy, designing APIs, improving developer experience (DX), creating developer documentation, building SDKs, planning API versioning and deprecation, building developer communities, creating integration marketplaces, or measuring platform health. Covers REST, GraphQL, webhooks, and platform ecosystems.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "platform-product-manager" with this command: npx skills add ncklrs/startup-os-skills/ncklrs-startup-os-skills-platform-product-manager

Platform Product Manager

Strategic product management expertise for API-first and developer-focused platforms — from API design and developer experience to ecosystem building and platform metrics.

Philosophy

Great platform products aren't about features. They're about making developers successful.

The best API and platform products:

  1. Developer experience is product experience — DX is your primary differentiator
  2. APIs are user interfaces — Design them with the same care as visual UIs
  3. Documentation is product — Great docs reduce support, increase adoption, drive success
  4. Ecosystem multiplies value — Your integrations make your platform stickier

How This Skill Works

When invoked, apply the guidelines in rules/ organized by:

  • api-* — API design principles, standards, and patterns
  • dx-* — Developer experience, onboarding, and success
  • docs-* — Developer documentation strategy and standards
  • sdk-* — SDK and library strategy
  • versioning-* — API versioning, deprecation, and migration
  • community-* — Developer community and ecosystem building
  • marketplace-* — Integration marketplace and partner strategy
  • metrics-* — Platform health and success metrics

Core Frameworks

Platform Maturity Model

StageFocusKey MetricsTeam Structure
FoundationCore API, basic docsAPI uptime, error ratesPM + Engineers
GrowthDX, SDKs, onboardingTime-to-first-call, activation+ DevRel, DX engineers
ScaleEcosystem, marketplaceIntegration count, partner revenue+ Partner team
PlatformNetwork effects, flywheelPlatform GMV, ecosystem valueFull platform org

The Developer Journey

┌─────────────┐   ┌─────────────┐   ┌─────────────┐   ┌─────────────┐
│  DISCOVER   │ → │   EVALUATE  │ → │   ADOPT     │ → │   EXPAND    │
│             │   │             │   │             │   │             │
│ - Search    │   │ - Docs      │   │ - Signup    │   │ - More APIs │
│ - Content   │   │ - Sandbox   │   │ - First call│   │ - Higher    │
│ - Referral  │   │ - Pricing   │   │ - Use case  │   │   volume    │
│             │   │             │   │   solved    │   │ - Referral  │
└─────────────┘   └─────────────┘   └─────────────┘   └─────────────┘

API Design Hierarchy

                    ┌─────────────────┐
                    │   CONSISTENCY   │  ← Predictable patterns
                    ├─────────────────┤
                    │   SIMPLICITY    │  ← Easy to understand
                    ├─────────────────┤
                    │   DISCOVERABILITY│ ← Self-documenting
                    ├─────────────────┤
                    │   RELIABILITY   │  ← Stable and trustworthy
                    ├─────────────────┤
                    │   PERFORMANCE   │  ← Fast and efficient
                    └─────────────────┘

Developer Success Metrics Stack

┌─────────────────────────────────────────────────────────────────┐
│                    BUSINESS OUTCOMES                            │
│        Revenue, Retention, Net Dollar Retention                 │
├─────────────────────────────────────────────────────────────────┤
│                    DEVELOPER SUCCESS                            │
│     Active Developers, API Calls, Use Cases Completed           │
├─────────────────────────────────────────────────────────────────┤
│                    DEVELOPER EXPERIENCE                         │
│   Time-to-First-Call, Activation Rate, Support Tickets          │
├─────────────────────────────────────────────────────────────────┤
│                    PLATFORM HEALTH                              │
│        Uptime, Latency, Error Rates, Documentation Quality      │
└─────────────────────────────────────────────────────────────────┘

Platform Types

TypeExamplesKey Success FactorPrimary Metric
Infrastructure APIStripe, Twilio, AWSReliability + DXAPI calls, uptime
Data APIPlaid, ClearbitData quality + freshnessData coverage
Aggregation PlatformZapier, SegmentIntegrations + easeConnections made
Developer ToolsGitHub, VercelWorkflow fit + speedActive projects
Embedded PlatformShopify AppsDistribution + valueInstall rate, GMV

API Style Comparison

StyleBest ForComplexityFlexibilityCaching
RESTCRUD operations, simple resourcesLowMediumExcellent
GraphQLComplex data fetching, mobileMediumHighManual
gRPCInternal services, high perfHighLowN/A
WebhooksReal-time events, async flowsLowMediumN/A
WebSocketBi-directional, real-timeMediumHighN/A

Anti-Patterns

  • API-first without developer-first — Technically great API that's hard to use
  • Documentation as afterthought — Docs written after API is "done"
  • Breaking changes without warning — Surprising developers with incompatibilities
  • Vanity integrations — Building integrations nobody uses for marketing
  • Platform before product-market fit — Building ecosystem before core value
  • Ignoring support signals — Not treating support tickets as product feedback
  • One-size-fits-all SDK — Same SDK strategy for all languages/use cases
  • Versioning without migration path — New versions without upgrade guides

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

proposal-writer

No summary provided by upstream source.

Repository SourceNeeds Review
255-ncklrs
General

website-copy-specialist

No summary provided by upstream source.

Repository SourceNeeds Review
120-ncklrs
General

remotion-animation

No summary provided by upstream source.

Repository SourceNeeds Review
120-ncklrs
General

seo-content-strategist

No summary provided by upstream source.

Repository SourceNeeds Review
118-ncklrs