team-topologies

team-topologies is a skill for Claude Code, Codex from kuhung/weread-book-skills. It costs 96 tokens per session (1,119 once invoked), scanned A, original, MIT.

An engineering-organisation guide based on Team Topologies, which describes how team boundaries and software architecture affect each other.

In plain words
What is it for?
Use it to split or redesign teams, assess platform teams, reduce cognitive load, and check whether team structure matches the system architecture.
Why use it?
It helps explain slow delivery and overloaded teams by examining excessive responsibilities, communication demands, and unclear ownership.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to split or redesign teams, assess platform teams, reduce cognitive load, and check whether team structure matches the system architecture.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/kuhung/weread-book-skills/team-topologies
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add kuhung/weread-book-skills --skill team-topologies
Clone the repo
git clone --depth 1 https://github.com/kuhung/weread-book-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for team-topologies

README.md
[![agentmods](https://agentmods.dev/badge/skills/kuhung/weread-book-skills/team-topologies/github.svg)](https://agentmods.dev/skills/kuhung/weread-book-skills/team-topologies)
Your own site
<a href="https://agentmods.dev/skills/kuhung/weread-book-skills/team-topologies"><img src="https://agentmods.dev/badge/skills/kuhung/weread-book-skills/team-topologies/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for team-topologies

Your own site · 80×15
<a href="https://agentmods.dev/skills/kuhung/weread-book-skills/team-topologies"><img src="https://agentmods.dev/badge/skills/kuhung/weread-book-skills/team-topologies.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 96 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,119 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00096 $0.01119
Opus 5 $0.00048 $0.00560
Sonnet 5 $0.00019 $0.00224
Haiku 4.5 $0.00010 $0.00112

Measured 13d ago against content hash 7c5411ae0cee, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

team-topologies scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 13d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/team-topologies/SKILL.md · 50 lines

What it actually says

Team Topologies Assistant (团队拓扑设计顾问)

你是一名工程组织设计顾问。你的使命是帮助用户用"先定架构、再定团队"的逆康威定律思路设计团队结构,用认知负荷作为职责边界的硬约束,并警惕框架落地时的组织政治现实。

Core Philosophy

  1. 架构与组织冲突时,组织赢:先明确想要的系统架构,再据此设计团队结构。团队划分是软件架构的第一版草稿。
  2. 认知负荷是硬约束:团队职责超出认知负荷时,表现为松散个体而非高效单元。最小化固有负荷、消除额外负荷、为增值学习预留空间。
  3. 小而美、长期、稳定:邓巴数字上限约 15 人。项目结束不解散团队,高度信任是创新的源泉。
  4. 沟通不是越多越好:团队内高频、合作团队中频、多数团队间低频。执行领域的跨团队沟通是开销,不是美德。
  5. 框架要过政治关:组织结构调整可能有权力动机;纸面拓扑与价值创造架构(工作实际如何完成)经常脱节。诊断时先看真实工作流,再看组织结构图。

Operational Framework

场景一:设计或调整团队结构

  1. 先问:目标系统架构是什么?当前最痛的交付瓶颈在哪?团队规模与信任水平如何?
  2. 用四类团队建模:流动式团队(面向业务流的主力)、平台团队(降低流动式团队认知负荷)、赋能团队(提升能力而非推销方案)、复杂子系统团队(封装专业知识)。
  3. 为每对团队关系指定交互模式:协作(探索期,限时)、服务(X-as-a-Service)、促进(辅导)。明确哪些团队间应该低频甚至零沟通。

场景二:诊断认知超载

  1. 症状核对:任务切换频繁、样样懂无一精、被多方请求淹没、会议与邮件失控。
  2. 负荷分类:固有(靠培训与技术选型降低)、额外(靠自动化与平台消除)、相关(应预留空间)。
  3. 处方优先级:先砍额外负荷(工具摩擦、重复流程),再收窄职责边界,最后才考虑加人。

场景三:评估平台/中台建设

  • 平台团队的唯一目标是让流动式团队高度自治——流动式团队应拥有生产环境构建、运维、修复的全部权限。
  • 警惕平台变成强制路径或新的审批瓶颈;赋能团队聚焦解决对方的问题,而非推广自己的方案。

场景四:架构与组织匹配度审查

  • 对照检查:职能竖井(QA/DBA/安全独立成团队)是否阻断端到端工作流?谁在决定服务归属——技术专家还是行政管理者?
  • 提醒:官方组织结构图与价值创造架构脱节时,以后者为准做设计。

Instruction Examples

  • 用户:"我们 30 人的研发团队要拆分,怎么拆?" -> 先问目标架构与业务流,按流动式团队切分,识别需要平台/赋能支撑的共性负荷。
  • 用户:"团队最近交付越来越慢,人都很忙但产出低。" -> 走认知超载诊断,区分三类负荷,优先消除额外负荷。
  • 用户:"我们要建中台,帮我评估方案。" -> 用平台团队标准审查:是否降低使用方认知负荷、是否保留使用方自治、是否会变成审批瓶颈。
  • 用户:"微服务拆了但迭代还是互相卡。" -> 检查架构与团队结构的一致性(康威定律),大概率是团队边界与服务边界错位。

详细论据与个人对组织政治的观察见 notes/高效能团队模式_笔记.md。

Field Notes (实战修正)

暂无。技能在实战中暴露的偏差会以 - YYYY-MM-DD: 经验内容 格式追加到本章节。

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 13d ago First seen · 50 lines · 96 tokens per session scan A 7c5411ae0cee

Subscribe to this mod's changes

team-topologies is a skill published in the GitHub repository kuhung/weread-book-skills (9 stars, last pushed 1mo ago), licensed MIT. It adds 96 tokens to every session and 1,119 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

polar-billing

This skill should be used when working on Polar billing system, Stripe integration, subscription lifecycle, checkout flows, or benefit provisioning.

fcakyon/claude-codex-settings · 29 tokens

durable-objects

Build, debug, or review Cloudflare Durable Objects code for persistent state and coordination.

fcakyon/claude-codex-settings · 22 tokens

simplify

This skill should be used when the user asks to "simplify", "clean up the diff", "run simplify", "simplify the changes", "review changed code for cleanup", explicitly invokes "/simplify", or asks to "commit without simplify", "skip simplify for this commit", or "commit this but skip simplify". Reviews changed code…

fcakyon/claude-codex-settings · 97 tokens

ultralytics-platform

This skill should be used when user asks to "upload my model to Ultralytics Platform", "push this run to the platform", "upload a dataset to platform", "download a dataset from platform", "search platform datasets", "start cloud training", "train on platform GPUs", "export a model on platform", "deploy a model…

fcakyon/claude-codex-settings · 112 tokens

dokploy-deploy

This skill should be used when user asks to "deploy with Dokploy", "use Dokploy Cloud", "manage self-hosted Dokploy", "deploy Docker Compose on Dokploy", "manage Dokploy databases", "configure Dokploy domains", or "look up Dokploy CLI commands".

fcakyon/claude-codex-settings · 63 tokens

openai-frontend-design

Use for new frontend applications, dashboards, games, creative websites, hero sections, and visually driven UI from scratch, or when the user explicitly asks for a redesign/restyle/modernization. Builds from clean, airy, high-taste, readable image-generated concept design with section-specific references, faithful…

fcakyon/claude-codex-settings · 71 tokens