Agent skill

Stakeholders Org Design

by nicepkg in nicepkg/ai-workflow

A skill your agent uses when designing organizational structure (team topologies, Conway's Law alignment), mapping stakeholders by power-interest for change initiatives, defining team interface…

MITAuto-check passed

Install Stakeholders Org Design

skills CLI
$ npx skills add nicepkg/ai-workflow --skill stakeholders-org-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nicepkg/ai-workflow stakeholders-org-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nicepkg/ai-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workflows/product-manager-workflow/.claude/skills/stakeholders-org-design .claude/skills/stakeholders-org-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
stakeholders-org-design
GitHub stars
285
Token cost
~3.1k tokens
SKILL.md length
1,231 words
Files
4
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when designing organizational structure (team topologies, Conway's Law alignment), mapping stakeholders by power-interest for change initiatives, defining team interface…

  • Works in 10 steps: Purpose → When to Use → What Is It → …
  • Designing organizational structure (team topologies
  • SKILL.md covers Table of Contents, Purpose, When to Use and What Is It, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Stakeholders Org Design is an agent skill from nicepkg/ai-workflow. Use when designing organizational structure (team topologies, Conway's Law alignment), mapping stakeholders by power-interest for change initiatives, defining team interface contracts (APIs, SLAs, decision rights, handoffs), assessing capability maturity (DORA, CMMC, agile maturity models), planning org restructures (functional to product teams, platform teams, shared services), or when user mentions "org design", "team structure", "stakeholder map", "team interfaces", "capability maturity", "Conway's Law", or…

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `resources/evaluators/rubric_stakeholders_org_design.json`, `resources/methodology.md` and `resources/template.md`).

The repository describes itself as: 🚀 170+ pre-built skills for Claude Code, Cursor, Codex & 14+ AI tools. Stop re-teaching your AI the same things. One command → instant domain expertise. Marketing, SEO, Trading… The licence is MIT.

When your agent uses it

  • Designing organizational structure (team topologies
  • Conways Law alignment)
  • Mapping stakeholders by power-interest for change initiatives
  • Defining team interface contracts (APIs

Example prompts

  • “org design”
  • “team structure”
  • “stakeholder map”
  • “/stakeholders-org-design”

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

  1. Purpose
  2. When to Use
  3. What Is It
  4. Workflow
  5. Stakeholder Mapping
  6. Team Interface Contracts
  7. Capability Maturity
  8. Common Patterns
  9. Guardrails
  10. Quick Reference

What it can do on your machine

Read from SKILL.md and the folder at commit d167b41. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Stakeholders Org Design loads about 3.1k tokens when it runs. Until then it costs about 137 tokens; SKILL.md has 1,231 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~137
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nicepkg/ai-workflow at commit d167b41, republished under its MIT licence (© nicepkg). 1,231 words, ~3,074 tokens.

Download SKILL.mdSave it as .claude/skills/stakeholders-org-design/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
stakeholders-org-design
description
Use when designing organizational structure (team topologies, Conway's Law alignment), mapping stakeholders by power-interest for change initiatives, defining team interface contracts (APIs, SLAs, decision rights, handoffs), assessing capability maturity (DORA, CMMC, agile maturity models), planning org restructures (functional to product teams, platform teams, shared services), or when user mentions "org design", "team structure", "stakeholder map", "team interfaces", "capability maturity", "Conway's Law", or "RACI".

Stakeholders & Organizational Design

Table of Contents

  1. Purpose
  2. When to Use
  3. What Is It
  4. Workflow
  5. Stakeholder Mapping
  6. Team Interface Contracts
  7. Capability Maturity
  8. Common Patterns
  9. Guardrails
  10. Quick Reference

Purpose

Stakeholders & Organizational Design provides frameworks for mapping influence networks, designing effective team structures aligned with system architecture (Conway's Law), defining clear team interfaces and responsibilities, and assessing organizational capability maturity to guide improvement.

When to Use

Invoke this skill when you need to:

  • Design or restructure organizational teams (functional → product, monolith → microservices teams, platform teams)
  • Map stakeholders for change initiatives (power-interest matrix, influence networks, champions/blockers)
  • Define team interfaces and contracts (APIs, SLAs, handoff protocols, decision rights)
  • Assess capability maturity (DevOps/DORA, security/CMMC, agile, data, design maturity models)
  • Apply Conway's Law (align team structure with desired system architecture)
  • Establish governance frameworks (RACI, decision rights, escalation paths)
  • Plan cross-functional collaboration models (product triads, embedded vs centralized)
  • Design team topologies (stream-aligned, platform, enabling, complicated-subsystem)

User phrases that trigger this skill:

  • "How should we structure our teams?"
  • "Map stakeholders for [initiative]"
  • "Define team interfaces"
  • "Assess our [capability] maturity"
  • "Conway's Law"
  • "Team Topologies"
  • "RACI matrix"

What Is It

A framework combining:

  1. Stakeholder Mapping: Power-interest matrix, influence networks, RACI for decision rights
  2. Organizational Design: Team structures aligned with architecture and strategy
  3. Team Interface Contracts: APIs, SLAs, handoff protocols, communication patterns
  4. Capability Maturity: Assessment using standard models (DORA, CMMC, CMM, custom rubrics)

Quick example (Platform Team Design):

Stakeholder Map:

  • High Power, High Interest: Engineering VP (sponsor), Product teams (customers)
  • High Power, Low Interest: CTO (keep satisfied with metrics)
  • Low Power, High Interest: Individual engineers (keep informed)

Team Structure:

  • Platform Team (8 people): Developer experience, infrastructure, observability
  • Interface: Self-service APIs, documentation, office hours
  • SLA: 99.9% uptime, <2 week feature delivery, <4hr critical bug fix

Capability Maturity (DORA metrics):

  • Deployment frequency: Daily → Weekly (target: Daily)
  • Lead time: 1 week → 2 days (target: <1 day)
  • MTTR: 4 hours → 1 hour (target: <1 hour)
  • Change failure rate: 15% → 5% (target: <5%)

Workflow

Copy this checklist and track your progress:

Org Design Progress:
- [ ] Step 1: Map stakeholders and influence
- [ ] Step 2: Define team structure and boundaries
- [ ] Step 3: Specify team interfaces and contracts
- [ ] Step 4: Assess capability maturity
- [ ] Step 5: Create transition plan with governance

Step 1: Map stakeholders and influence

Identify all stakeholders, categorize by power-interest, map influence networks. See Stakeholder Mapping for power-interest matrix and RACI frameworks.

Step 2: Define team structure and boundaries

Design teams aligned with architecture and strategy. For straightforward restructuring → Use resources/template.md. For complex org design with Conway's Law → Study resources/methodology.md.

Step 3: Specify team interfaces and contracts

Define APIs, SLAs, handoff protocols, decision rights between teams. See Team Interface Contracts for contract patterns.

Step 4: Assess capability maturity

Evaluate current state using maturity models (DORA, CMMC, custom). See Capability Maturity for assessment frameworks.

Step 5: Create transition plan with governance

Define migration path, decision rights, review cadence. Self-check using resources/evaluators/rubric_stakeholders_org_design.json. Minimum standard: Average score ≥ 3.5.

Stakeholder Mapping

Power-Interest Matrix
QuadrantEngagementExample
High Power, High InterestManage Closely (frequent communication)Executive sponsor, product owner
High Power, Low InterestKeep Satisfied (status updates)CFO for tech project, legal
Low Power, High InterestKeep Informed (engage for feedback)Individual contributors, early adopters
Low Power, Low InterestMonitor (minimal engagement)Peripheral teams
RACI Matrix
  • R - Responsible: Does the work (can be multiple) — Example: Engineering team builds feature
  • A - Accountable: Owns outcome (exactly one per decision) — Example: Product manager accountable for feature success
  • C - Consulted: Provides input before decision (two-way) — Example: Security team consulted on auth design
  • I - Informed: Notified after decision (one-way) — Example: Support team informed of launch
Influence Network Mapping

Identify: Champions (advocates), Blockers (resistors), Bridges (connectors), Gatekeepers (control access) Map: Who influences whom? Formal vs informal power, trust relationships, communication patterns

Team Interface Contracts

API Contracts

Specify: Endpoints, data format/schemas, authentication, rate limits, versioning/backward compatibility Example: Service: User Auth API | Owner: Identity Team | Endpoints: /auth/login, /auth/token | SLA: 99.95% uptime, <100ms p95

SLA (Service Level Agreements)

Define: Availability (99.9%, 99.99%), Performance (p50/p95/p99 latency), Support response times (critical: 1hr, high: 4hr, medium: 1 day), Capacity (requests/sec, storage)

Handoff Protocols

Design → Engineering: Specs, prototype, design review sign-off | Engineering → QA: Feature complete, test plan, staging | Engineering → Support: Docs, runbook, training | Research → Product: Findings, recommendations, prototypes

Decision Rights (DACI)

D - Driver (orchestrates), A - Approver (exactly one), C - Contributors (input), I - Informed (notified) Examples: Architectural (Tech Lead approves, Architects contribute) | Hiring (Hiring Manager approves, Interviewers contribute) | Roadmap (PM approves, Eng/Design/Sales contribute)

Capability Maturity

DORA Metrics (DevOps Maturity)
MetricEliteHighMediumLow
Deployment FrequencyMultiple/dayWeekly-dailyMonthly-weekly<Monthly
Lead Time<1 hour<1 day1 week-1 month>1 month
MTTR<1 hour<1 day1 day-1 week>1 week
Change Failure Rate0-15%16-30%31-45%>45%
Show full SKILL.md (482 more words)Show less
Generic Maturity Levels (CMM)

Level 1 Initial: Unpredictable, reactive | Level 2 Repeatable: Basic PM | Level 3 Defined: Documented, standardized | Level 4 Measured: Data-driven | Level 5 Optimizing: Continuous improvement

Custom Capability Assessment

Template: Capability Name | Current Level (1-5 with evidence) | Target Level | Gap | Action Items

Common Patterns

Pattern 1: Functional → Product Teams (Spotify Model)

  • Before: Frontend team, Backend team, QA team, DevOps team
  • After: Product Squad 1 (full-stack), Product Squad 2 (full-stack)
  • Interfaces: Squads own end-to-end features, shared platform team for infrastructure
  • Benefit: Faster delivery, reduced handoffs, clear ownership

Pattern 2: Platform Team Extraction

  • Trigger: Multiple product teams duplicating infrastructure work
  • Design: Create platform team providing self-service tools
  • Interface: Platform team APIs + documentation, office hours, SLA
  • Staffing: 10-15% of engineering (1 platform engineer per 7-10 product engineers)

Pattern 3: Embedded vs Centralized Specialists

  • Embedded: Security/QA/Data engineers within product teams (close collaboration)
  • Centralized: Specialists in separate team (consistency, expertise depth)
  • Hybrid: Center of Excellence (set standards) + Embedded (implementation)
  • Choice Factors: Team size, maturity, domain complexity

Pattern 4: Conway's Law Alignment

  • Principle: System design mirrors communication structure
  • Application: Design teams to match desired architecture
  • Example: Microservices → Small autonomous teams per service
  • Anti-pattern: Monolithic team structure → Monolithic architecture persists

Pattern 5: Team Topologies (4 Fundamental Types)

  • Stream-Aligned: Product teams, aligned with flow of change
  • Platform: Internal products enabling stream-aligned teams
  • Enabling: Build capability in stream-aligned teams (temporary)
  • Complicated-Subsystem: Specialists for complex areas (ML, security)

Guardrails

Conway's Law is inevitable:

  • Teams will produce systems mirroring their communication structure
  • Design teams intentionally for desired architecture
  • Reorganizing teams = reorganizing system boundaries

Team size limits:

  • 2-pizza team: 5-9 people (Amazon)
  • Dunbar's number: 5-15 close working relationships
  • Too small (<3): Fragile, lacks skills diversity
  • Too large (>12): Communication overhead, subgroups form

Cognitive load per team:

  • Each team has limited capacity for domains/systems
  • Simple: 1 domain per team
  • Complicated: 2-3 related domains
  • Complex: Max 1 complex domain per team

Interface ownership clarity:

  • Every interface needs one clear owner
  • Shared ownership = no ownership
  • Document: Owner, SLA, contact, escalation

Avoid matrix hell:

  • Minimize dual reporting (confusing accountability)
  • If matrix needed: Clear primary vs secondary manager
  • Define decision rights explicitly (RACI/DACI)

Stakeholder fatigue:

  • Don't manage all stakeholders equally
  • High power/interest = frequent engagement
  • Low power/interest = minimal updates
  • Adjust as power/interest shifts

Maturity assessment realism:

  • Don't grade on aspirations
  • Evidence-based assessment (metrics, artifacts, observation)
  • Common pitfall: Over-rating current state
  • Use external benchmarks when available

Quick Reference

Resources:

5-Step Process: Map Stakeholders → Define Teams → Specify Interfaces → Assess Maturity → Transition Plan

Stakeholder Mapping: Power-Interest Matrix (High/Low × High/Low), RACI (Responsible/Accountable/Consulted/Informed), Influence Networks

Team Interfaces: API contracts, SLAs (availability/performance/support), handoff protocols, decision rights (DACI/RAPID)

Maturity Models: DORA (deployment frequency, lead time, MTTR, change failure rate), Generic CMM (5 levels), Custom assessments

Team Types: Stream-Aligned (product), Platform (internal products), Enabling (capability building), Complicated-Subsystem (specialists)

Guardrails: Conway's Law, team size (2-pizza, Dunbar), cognitive load limits, interface ownership clarity, avoid matrix hell

© nicepkg, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in workflows/product-manager-workflow/.claude/skills/stakeholders-org-design of nicepkg/ai-workflow.

  • SKILL.md
  • resources/evaluators/rubric_stakeholders_org_design.json
  • resources/methodology.md
  • resources/template.md

Open the folder on GitHubat commit d167b41

Compare with similar skills

Stakeholders Org Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Stakeholders Org Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Stakeholders Org Design this skillnicepkg/ai-workflow285—~3.1kAutomated safety check: PassMIT
Design Systemaffaan-m/ECC275k—~698Automated safety check: PassMIT
Design Guidepaperclipai/paperclip99k1 repos~3.1kAutomated safety check: PassMIT
Design Audit Against Rams' Principlesthedotmack/claude-mem98k—~4.6kAutomated safety check: PassApache-2.0
Figma Design to Codewarpdotdev/warp65k4 repos~2.9kAutomated safety check: PassAGPL-3.0
Design Consultationgarrytan/gstack136k—~15kAutomated safety check: NotesMIT

Similar skills

  • Design System

    affaan-m/ECC

    Generate a design system from an existing codebase or audit one for visual consistency: extract tokens (colors, typography, spacing, shadows) into design-tokens.json and CSS custom properties with…

    275k GitHub stars~698 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Design Guide

    paperclipai/paperclip

    Paperclip UI design system guide for building consistent, reusable frontend components.

    99k GitHub starsUsed in 1 repo~3.1k tokens
    Frontend & DesignAuto-check passed
  • Audits a design against Dieter Rams' ten principles of good design, scores each with evidence, and hands off a make-plan prompt for a new, refined or redesigned outcome.

    98k GitHub stars~4.6k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Figma Design to Code

    warpdotdev/warp

    Turns a Figma frame or component into production code that matches the design, using the Figma MCP server and the project's own design system.

    65k GitHub starsUsed in 4 repos~2.9k tokens
    Frontend & DesignAuto-check passed
  • Design Consultation

    garrytan/gstack

    Learns about your product, studies the landscape and writes a DESIGN.md with a full design system covering type, color, layout, spacing and motion.

    136k GitHub stars~15k tokensUpdated today
    Frontend & DesignAuto-check: notes
  • Product Design Workflow Bundle

    XiaomiMiMo/MiMo-Code

    Entry point to a bundle of product design workflows covering context, research, audits, ideation, URL or image to code, design QA and sharing a prototype.

    14k GitHub stars~721 tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed

More from nicepkg/ai-workflow

All 61 skills in this repo
  • Capture Triage

    nicepkg/ai-workflow

    Processes Drafts Pro captures from the Inbox folder. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~3k tokensUpdated 8 mo ago
    Auto-check passed
  • Legacy To AI Ready

    nicepkg/ai-workflow

    Transform legacy codebases into AI-ready projects with Claude Code configurations.

    285 GitHub stars~2.2k tokensUpdated 8 mo ago
    Auto-check: notes
  • Newsletter Coach

    nicepkg/ai-workflow

    Writing coach that extracts educational content from your daily experiences and turns it into publish-ready newsletter drafts.

    285 GitHub stars~3.7k tokensUpdated 8 mo ago
    Auto-check passed
  • Webfluence

    nicepkg/ai-workflow

    Content web architecture framework. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~1.4k tokensUpdated 8 mo ago
    Auto-check passed
  • Workflow Creator

    nicepkg/ai-workflow

    Create complete Claude Code workflow directories with curated skills.

    285 GitHub stars~2.6k tokensUpdated 8 mo ago
    Auto-check passed
  • Media Processing

    nicepkg/ai-workflow

    Video/audio/image processing with FFmpeg and ImageMagick. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~2.4k tokensUpdated 8 mo ago
    Auto-check: notes

Questions about Stakeholders Org Design

What does Stakeholders Org Design do?

A skill your agent uses when designing organizational structure (team topologies, Conway's Law alignment), mapping stakeholders by power-interest for change initiatives, defining team interface…. Stakeholders Org Design is an agent skill from nicepkg/ai-workflow.

When should I use Stakeholders Org Design?

Stakeholders Org Design fits situations like: designing organizational structure (team topologies; conways Law alignment); mapping stakeholders by power-interest for change initiatives; defining team interface contracts (APIs.

How do I install Stakeholders Org Design in Claude Code?

Run `npx skills add nicepkg/ai-workflow --skill stakeholders-org-design -a claude-code`. Or copy the skill folder (workflows/product-manager-workflow/.claude/skills/stakeholders-org-design in nicepkg/ai-workflow) into .claude/skills/stakeholders-org-design in your project. Claude Code loads it when a task matches its description.

How do I install Stakeholders Org Design in Codex?

Run `npx skills add nicepkg/ai-workflow --skill stakeholders-org-design -a codex`. Or copy the skill folder (workflows/product-manager-workflow/.claude/skills/stakeholders-org-design in nicepkg/ai-workflow) into .agents/skills/stakeholders-org-design in your project. Codex loads it when a task matches its description.

Can I use Stakeholders Org Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nicepkg/ai-workflow --skill stakeholders-org-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/stakeholders-org-design, .gemini/skills/stakeholders-org-design, .github/skills/stakeholders-org-design and .opencode/skills/stakeholders-org-design in your project.

What does Stakeholders Org Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Stakeholders Org Design is instructions for the agent only.

Does Stakeholders Org Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Stakeholders Org Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Stakeholders Org Design use?

Stakeholders Org Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Stakeholders Org Design use?

About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Stakeholders Org Design?

Skills that share tags, products or a category with Stakeholders Org Design: Design System (affaan-m/ECC, 275k stars), Design Guide (paperclipai/paperclip, 99k stars), Design Audit Against Rams' Principles (thedotmack/claude-mem, 98k stars) and Figma Design to Code (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Stakeholders Org Design?

nicepkg (a GitHub organization) maintains it in nicepkg/ai-workflow, which has 285 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on January 20, 2026.

Source: nicepkg/ai-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.