skill-developer-relationslisted
Install: claude install-skill saitarrun/Sdlc-ai-workflow
# Skill: Developer Relations
## Overview
Develop SDKs, guides, and external-facing communication that makes your product accessible and enjoyable for third-party developers.
## Core Principles
### 1. **SDK Design**
- **Single Responsibility**: One SDK = one language, one purpose
- **Familiar Patterns**: Match community conventions (not your internal patterns)
- Python: classes, context managers, snake_case
- JavaScript: async/await, CommonJS or ESM, camelCase
- Go: interfaces, structs, package-level functions
- **Minimal Dependencies**: Reduce transitive dependency bloat
- **Versioning**: Semantic versioning, clear deprecation paths
### 2. **Code Samples**
- **Real, Runnable**: Not pseudocode — every sample executes
- **Progressive Complexity**: Start simple, build up
- Hello World (authentication only)
- Basic operation (read/write)
- Advanced pattern (error handling, retries, batching)
- **Error Paths**: Show what failure looks like and how to handle it
- **Tested**: CI verifies samples remain accurate as APIs evolve
### 3. **Documentation for Developers**
- **Task-First, Not API-First**:
- Instead of: "Query using GET /users/{id}"
- Write: "To fetch a user by ID: [sample code]"
- **Examples Over Explanation**: Code sample > prose description
- **Quick Start**: First 5 minutes = working integration (not configuration)
- **API Reference**: Auto-generated from OpenAPI/GraphQL schema (not hand-written)
### 4. **Developer Experience (DX)**
- **Obvious Err