devrel-team-structure

Designs developer relations org structures, reporting lines, coverage maps, and interlocks into an org design brief.

2|Updated Sep 6, 2026
One-click install
npx skills add https://github.com/samber/developer-relations-skills --skill devrel-team-structure-samber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devrel-team-structure
Source: https://github.com/samber/developer-relations-skills/tree/main/skills/devrel-team-structure
Command: npx skills add https://github.com/samber/developer-relations-skills --skill devrel-team-structure-samber

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deciding where developer relations should report, how to shape the team, and who owns which surfaces is a recurring political fight with no industry consensus. This Skill turns that argument into a structured decision process that ends in a written, approvable DevRel org design brief. ## Core Features & Use Cases - Reporting line decision: Chooses between marketing, product, engineering, CEO, or sales based on the funded driver, and forces each choice to name what it starves and who covers the gap. - Team shape selection: Evaluates centralized, hub-and-spoke, split-by-focus, and embedded shapes against staffing floors, coordination cost, and reversibility, deleting shapes the headcount rules out. - Coverage and interlocks: Maps the six DevRel functions to owned/shared/unowned/refused states and writes one Team Topologies interaction mode per adjacent team with a named arbiter. - Use Case: A COO must settle whether three DevRel people report to the VP Marketing or the new VP Engineering before a leadership offsite. The Skill refuses to pick a line until the funded driver is named, then produces a four-part line statement with a review date. ## Quick Start Ask the assistant to design your developer relations org structure, for example: "Our devrel team reports to the CTO and it isn't working - help me decide where it should sit and how to structure it."

Frequently Asked Questions about devrel-team-structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Should developer relations report to marketing, product, or engineering?

No reporting line holds a majority - the 2024 State of Developer Relations survey shows marketing 33.1%, product 21.7%, CEO 20.3%, engineering 19.9%, sales 3.2%. The Skill picks the line whose leader owns the funded driver, then names what that line starves and who covers the gap.

How do I structure a developer relations team?

Start with a work inventory listing every surface with a named owner, manager, hours per week, and what breaks if it stops. Then choose a shape - centralized, hub-and-spoke, split by focus, or embedded - against staffing floors; under roughly ten full-time people, centralized is the only viable candidate.

What is the right ratio of developer advocates to developers?

There is no valid ratio - every circulating figure is a single-company anecdote, so the Skill refuses to quote one. Headcount is derived instead from the surface inventory, with one accountable owner plus one backup per surface, planned against at most 70% of declared capacity.

When should advocates be embedded in product teams?

Embedded is promoted only when four conditions hold: the funded driver is product input, product lines have genuinely different audiences, each host team can fund and level the role, and a named craft owner survives outside the host teams. It is the least reversible shape and usually costs the shared ladder and calendar.

How should devrel and docs teams divide ownership?

The Skill writes interlock lines rather than merging teams: one Team Topologies mode per adjacent team, what crosses the boundary, and a named arbiter. Technical writing is staffed on only 42.7% of DevRel teams, so its ownership must be declared explicitly on the coverage map.

What are the limitations of this org design approach?

It refuses to provide headcount ratios, compensation bands, or levelled maturity models, since no measured standards exist for them. Span-of-control checks come from general management practice only, and the ten-person shape threshold is a chosen baseline, not a published finding.