Skip to content

An agent organization structured as a company — 15+ departments, 125+ skills, each independently installable, citing the standards and regulators that settle the question. Runs in Claude Code and ChatGPT.

Interactive org chart, generated from the tree (#10)

Chris Brock237b275e66e6
diff --git a/README.md b/README.md
index 84bf89e..6847043 100644
--- a/README.md
+++ b/README.md
@@ -327,6 +327,7 @@ plugins/<department>/
docs/AGENT-SURFACES.md every path has exactly one owner, enforced in CI
docs/DECISION-LOG.md numbered decisions with options and recommendations
docs/USE-CASES.md situations worked end to end across departments
+docs/org-chart.html interactive org chart, searchable across every skill
```
Agents split by **exclusive write surface**, not by topic — a topic split has no checkable
diff --git a/docs/org-chart.html b/docs/org-chart.html
new file mode 100644
index 0000000..b646ee8
--- /dev/null
+++ b/docs/org-chart.html
@@ -0,0 +1,382 @@
+<meta charset="utf-8">
+<title>headcount org chart</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Archivo:wght@600;700&family=IBM+Plex+Mono:wght@400;500&family=IBM+Plex+Sans:wght@400;500;600&display=swap">
+<style>
+ /* Palette inherited from the repository's existing identity — the badge row and the social
+ preview card — rather than invented here. Light ground is a cool neutral: the accent is
+ already terracotta, and a warm cream under it is the stock look. */
+ :root {
+ --ground:#F6F7F9; --surface:#FFFFFF; --surface-2:#EEF1F4;
+ --line:#D8DEE6; --line-strong:#B9C3CE;
+ --ink:#141A21; --ink-2:#4A5866; --ink-3:#78889A;
+ --accent:#C2663F; --accent-ink:#FFFFFF; --accent-soft:rgba(194,102,63,.10);
+ --shadow:0 1px 2px rgba(20,26,33,.06), 0 8px 24px -12px rgba(20,26,33,.18);
+ --focus:#C2663F;
+ }
+ @media (prefers-color-scheme: dark) {
+ :root:not([data-theme="light"]) {
+ --ground:#0B0E14; --surface:#141A22; --surface-2:#1B222C;
+ --line:#252E3A; --line-strong:#3A4553;
+ --ink:#E6EDF3; --ink-2:#9FB0C3; --ink-3:#71818F;
+ --accent:#D97757; --accent-ink:#1A1006; --accent-soft:rgba(217,119,87,.13);
+ --shadow:0 1px 2px rgba(0,0,0,.4), 0 10px 30px -14px rgba(0,0,0,.7);
+ --focus:#D97757;
+ }
+ }
+ :root[data-theme="dark"] {
+ --ground:#0B0E14; --surface:#141A22; --surface-2:#1B222C;
+ --line:#252E3A; --line-strong:#3A4553;
+ --ink:#E6EDF3; --ink-2:#9FB0C3; --ink-3:#71818F;
+ --accent:#D97757; --accent-ink:#1A1006; --accent-soft:rgba(217,119,87,.13);
+ --shadow:0 1px 2px rgba(0,0,0,.4), 0 10px 30px -14px rgba(0,0,0,.7);
+ --focus:#D97757;
+ }
+
+ * { box-sizing:border-box; }
+ body {
+ margin:0; background:var(--ground); color:var(--ink);
+ font-family:"IBM Plex Sans","Helvetica Neue",Arial,sans-serif;
+ font-size:15px; line-height:1.5;
+ -webkit-font-smoothing:antialiased;
+ }
+ .wrap { max-width:1180px; margin:0 auto; padding:52px 28px 80px; }
+
+ /* ---- masthead ---- */
+ .eyebrow {
+ font-family:"IBM Plex Mono",monospace; font-size:12px; letter-spacing:.16em;
+ text-transform:uppercase; color:var(--ink-3);
+ }
+ h1 {
+ font-family:Archivo,"Helvetica Neue",sans-serif; font-weight:700;
+ font-size:clamp(34px,5vw,50px); letter-spacing:-.03em; line-height:1.05;
+ margin:12px 0 0; text-wrap:balance;
+ }
+ .lede { color:var(--ink-2); margin:12px 0 0; max-width:60ch; }
+ .figures { display:flex; flex-wrap:wrap; gap:26px; margin-top:26px; }
+ .figure b {
+ display:block; font-family:Archivo,sans-serif; font-weight:700;
+ font-size:27px; letter-spacing:-.02em; font-variant-numeric:tabular-nums;
+ }
+ .figure span {
+ font-family:"IBM Plex Mono",monospace; font-size:11px; letter-spacing:.13em;
+ text-transform:uppercase; color:var(--ink-3);
+ }
+
+ /* ---- controls ---- */
+ .controls {
+ display:flex; flex-wrap:wrap; gap:10px; align-items:center;
+ margin:34px 0 8px; position:sticky; top:0; z-index:5;
+ background:var(--ground); padding:12px 0; border-bottom:1px solid var(--line);
+ }
+ #q {
+ flex:1 1 260px; min-width:0; padding:10px 13px;
+ background:var(--surface); color:var(--ink);
+ border:1px solid var(--line-strong); border-radius:8px;
+ font-family:"IBM Plex Sans",sans-serif; font-size:14px;
+ }
+ #q::placeholder { color:var(--ink-3); }
+ .btn {
+ padding:10px 14px; background:var(--surface); color:var(--ink-2);
+ border:1px solid var(--line-strong); border-radius:8px; cursor:pointer;
+ font-family:"IBM Plex Sans",sans-serif; font-size:13px; font-weight:500;
+ }
+ .btn:hover { color:var(--ink); border-color:var(--ink-3); }
+ .btn[aria-pressed="true"] {
+ background:var(--accent-soft); border-color:var(--accent); color:var(--accent);
+ }
+ #count {
+ font-family:"IBM Plex Mono",monospace; font-size:12px; color:var(--ink-3);
+ font-variant-numeric:tabular-nums; white-space:nowrap;
+ }
+ :focus-visible { outline:2px solid var(--focus); outline-offset:2px; }
+
+ /* ---- chief executive + reviewer rail ---- */
+ .top { margin:38px 0 0; display:flex; flex-direction:column; align-items:center; }
+ .ceo {
+ background:var(--accent); color:var(--accent-ink);
+ border-radius:11px; padding:13px 26px; text-align:center; box-shadow:var(--shadow);
+ }
+ .ceo b {
+ font-family:Archivo,sans-serif; font-weight:700; font-size:17px; letter-spacing:-.01em;
+ display:block;
+ }
+ .ceo span { font-family:"IBM Plex Mono",monospace; font-size:11px; opacity:.8; }
+ .stem { width:2px; height:26px; background:var(--line-strong); }
+
+ .rail {
+ width:100%; border:1px dashed var(--accent); border-radius:12px;
+ background:var(--accent-soft); padding:16px 18px;
+ display:flex; flex-direction:column; gap:14px;
+ }
+ .rail-label {
+ font-family:"IBM Plex Mono",monospace; font-size:11px; letter-spacing:.13em;
+ text-transform:uppercase; color:var(--accent); text-align:center;
+ }
+ .rail-note {
+ text-align:center; color:var(--ink-2); font-size:13px;
+ max-width:66ch; margin:0 auto;
+ }
+ .rail-cards {
+ display:grid; gap:14px; grid-template-columns:repeat(auto-fit,minmax(260px,1fr));
+ }
+
+ /* ---- department grid ---- */
+ .grid {
+ margin-top:26px; display:grid; gap:14px;
+ grid-template-columns:repeat(auto-fill,minmax(290px,1fr));
+ }
+ .dept {
+ background:var(--surface); border:1px solid var(--line); border-radius:12px;
+ overflow:hidden; transition:border-color .12s ease;
+ }
+ .dept:hover { border-color:var(--line-strong); }
+ .dept.rev { border-color:var(--accent); }
+ .dept.open { border-color:var(--ink-3); box-shadow:var(--shadow); }
+ .dept.hidden { display:none; }
+
+ .head {
+ width:100%; text-align:left; background:none; border:0; cursor:pointer;
+ padding:15px 16px; display:flex; gap:12px; align-items:baseline; color:inherit;
+ font-family:inherit;
+ }
+ .head h2 {
+ margin:0; font-family:Archivo,sans-serif; font-weight:600; font-size:16px;
+ letter-spacing:-.012em; flex:1;
+ }
+ .role {
+ font-family:"IBM Plex Mono",monospace; font-size:11px; color:var(--ink-3);
+ white-space:nowrap;
+ }
+ .n {
+ font-family:"IBM Plex Mono",monospace; font-size:12px; color:var(--ink-2);
+ font-variant-numeric:tabular-nums;
+ }
+ .slug {
+ display:block; font-family:"IBM Plex Mono",monospace; font-size:11px;
+ color:var(--ink-3); margin-top:3px; font-weight:400;
+ }
+ .revtag {
+ font-family:"IBM Plex Mono",monospace; font-size:10px; letter-spacing:.1em;
+ text-transform:uppercase; color:var(--accent);
+ border:1px solid var(--accent); border-radius:4px; padding:1px 5px;
+ }
+
+ .body { display:none; border-top:1px solid var(--line); }
+ .dept.open .body { display:block; }
+ .install {
+ display:flex; gap:8px; align-items:center; padding:11px 16px;
+ background:var(--surface-2); border-bottom:1px solid var(--line);
+ }
+ .install code {
+ font-family:"IBM Plex Mono",monospace; font-size:12px; color:var(--ink-2);
+ overflow-x:auto; white-space:nowrap; flex:1; min-width:0;
+ }
+ .copy {
+ border:1px solid var(--line-strong); background:var(--surface); color:var(--ink-2);
+ border-radius:6px; padding:4px 9px; font-size:11px; cursor:pointer;
+ font-family:"IBM Plex Mono",monospace; white-space:nowrap;
+ }
+ .copy:hover { color:var(--ink); }
+
+ ul { list-style:none; margin:0; padding:0; }
+ li { border-bottom:1px solid var(--line); }
+ li:last-child { border-bottom:0; }
+ li.hidden { display:none; }
+ li a {
+ display:block; padding:12px 16px; text-decoration:none; color:inherit;
+ }
+ li a:hover { background:var(--surface-2); }
+ .sname {
+ font-family:"IBM Plex Mono",monospace; font-size:13px; font-weight:500;
+ color:var(--accent);
+ }
+ .sdesc { color:var(--ink-2); font-size:13.5px; margin-top:3px; }
+
+ .empty {
+ display:none; text-align:center; padding:56px 20px; color:var(--ink-3);
+ }
+ .empty.on { display:block; }
+ footer {
+ margin-top:52px; padding-top:20px; border-top:1px solid var(--line);
+ color:var(--ink-3); font-size:13px;
+ display:flex; flex-wrap:wrap; gap:10px; justify-content:space-between;
+ }
+ footer a { color:var(--ink-2); }
+ mark { background:var(--accent-soft); color:inherit; border-radius:2px; }
+ @media (prefers-reduced-motion:reduce) { * { transition:none !important; } }
+</style>
+
+<div class="wrap">
+ <div class="eyebrow">cbrock84 / headcount</div>
+ <h1>The org chart</h1>
+ <p class="lede">
+ An agent organization for Claude Code, structured as a company. Every department installs
+ independently. Search across every skill, or open a department to see what it holds.
+ </p>
+ <div class="figures" id="figures"></div>
+
+ <div class="controls">
+ <input id="q" type="search" placeholder="Search 135 skills — try “threat”, “pricing”, “backup”…" autocomplete="off">
+ <button class="btn" id="revonly" aria-pressed="false">Reviewer-class only</button>
+ <button class="btn" id="expand">Expand all</button>
+ <span id="count"></span>
+ </div>
+
+ <div class="top">
+ <div class="ceo"><b>Chief Executive</b><span>executive</span></div>
+ <div class="stem"></div>
+ <div class="rail" id="rail">
+ <div class="rail-label">Reviewer-class — reports to the chief executive</div>
+ <p class="rail-note">
+ Security and Legal&nbsp;&amp; Risk review what the other departments commit to, and their
+ blocking findings are not overrulable by the department under review. That is why they report
+ to the chief executive rather than into the function they oversee.
+ </p>
+ <div class="rail-cards" id="rail-cards"></div>
+ </div>
+ </div>
+
+ <div class="grid" id="grid"></div>
+ <div class="empty" id="empty">No skill or department matches that.</div>
+
+ <footer>
+ <span>Generated from the repository tree — <code>scripts/build-org-chart.py</code></span>
+ <span><a href="https://github.com/cbrock84/headcount">github.com/cbrock84/headcount</a> · MIT</span>
+ </footer>
+</div>
+
+<script>
+const DEPTS = [{"slug": "executive", "title": "Office of the CEO", "exec": "Chief Executive", "reviewer": false, "skills": [{"name": "agent-hierarchy", "summary": "Designs orchestrator-and-subagent hierarchies for a repository — splitting agents by exclusive write surface, pairing every producer with an independ…", "trigger": "Designs orchestrator-and-subagent hierarchies for a repository — splitting agents by exclusive write surface, pairing every producer with an independent auditor, and enforcing the split with a script that runs in CI. Use this whenever the user wants to set up, expand, audit, or fix a multi-agent or subagent structure for a codebase; asks how to divide work between agents; wants agent charters, roles, or a surface map written; or is hitting agents that collide on the same files, review their own work, or drift from their remit. Also use when sizing a roster or deciding whether a new agent is justified.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/executive/skills/agent-hierarchy/SKILL.md"}, {"name": "ai-research-analyst", "summary": "Produces executive-level research — market sizing, competitor mapping, trend analysis, and strategic intelligence — grounded in cited sources with th…", "trigger": "Produces executive-level research — market sizing, competitor mapping, trend analysis, and strategic intelligence — grounded in cited sources with the confidence in each claim made explicit. Use this to analyze a market or industry, map competitors, evaluate a market-entry or build-versus-buy decision, produce a research brief, or assemble evidence for a decision. Also use when comparing options that need a structured, evidence-based verdict rather than an opinion.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/executive/skills/ai-research-analyst/SKILL.md"}, {"name": "business-growth-consultant", "summary": "Finds the single constraint currently limiting a business's growth and the highest-leverage moves against it, rather than producing a list of everyth…", "trigger": "Finds the single constraint currently limiting a business's growth and the highest-leverage moves against it, rather than producing a list of everything that could be improved. Use this when growth has stalled or slowed, when deciding where to spend limited time or budget, when revenue rises but profit does not, when prioritizing growth initiatives, or when a business feels busy without compounding.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/executive/skills/business-growth-consultant/SKILL.md"}, {"name": "ceo-advisor", "summary": "Pressure-tests a decision, plan, or idea before it is committed to — surfacing the assumption it rests on, the case against it, and what would have t…", "trigger": "Pressure-tests a decision, plan, or idea before it is committed to — surfacing the assumption it rests on, the case against it, and what would have to be true for it to work. Use this when weighing options, when a plan needs challenging before commitment, when you have already decided and want a genuine gut check, when processing meeting notes into decisions, or when competing initiatives need ranking. Distinct from `chief-executive`, which owns direction; this one interrogates a specific decision.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/executive/skills/ceo-advisor/SKILL.md"}, {"name": "chief-executive", "summary": "Sets direction, allocates capital and attention, and makes the calls no one else can make", "trigger": "Sets direction, allocates capital and attention, and makes the calls no one else can make. Use this when a decision spans more than one function, when priorities conflict and something must be cut, when a plan needs pressure-testing before commitment, or when the question is what the organization should do rather than how to do it. Also use to route a request to the right executive when it is unclear who owns it.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/executive/skills/chief-executive/SKILL.md"}, {"name": "saas-idea-validator", "summary": "Evaluates a software or startup idea against problem, market, competition, monetization, defensibility, and execution, and returns a verdict rather t…", "trigger": "Evaluates a software or startup idea against problem, market, competition, monetization, defensibility, and execution, and returns a verdict rather than encouragement. Use this when an idea needs pressure-testing before anyone builds, when deciding whether something is worth pursuing, when assessing competition or willingness to pay, or when a validated idea needs a first-customers and MVP plan. Default to scrutiny; the useful answer is usually the unwelcome one.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/executive/skills/saas-idea-validator/SKILL.md"}]}, {"slug": "technology", "title": "Technology", "exec": "CTO / CIO", "reviewer": false, "skills": [{"name": "ai-workflow-architect", "summary": "Designs AI systems, automations, and agent workflows for a business — identifying which manual work is worth automating, how to structure the system,…", "trigger": "Designs AI systems, automations, and agent workflows for a business — identifying which manual work is worth automating, how to structure the system, which tools fit, and what could go wrong. Use this to automate part of an operation, design an agent or MCP workflow, reduce repetitive manual work, connect tools into a system, decide which automation to build first, or audit an automation that is not delivering.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/ai-workflow-architect/SKILL.md"}, {"name": "api-design", "summary": "Designs interfaces that survive their consumers — resource modelling, errors, versioning, pagination, and compatibility", "trigger": "Designs interfaces that survive their consumers — resource modelling, errors, versioning, pagination, and compatibility. Use this to design a new API, review one before it ships, decide how to version or deprecate, fix an interface consumers keep misusing, or work out whether a change is breaking.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/api-design/SKILL.md"}, {"name": "branch-and-worktree-workflow", "summary": "Isolates feature work in its own branch or worktree and integrates it cleanly when done", "trigger": "Isolates feature work in its own branch or worktree and integrates it cleanly when done. Use this when starting work that should not disturb the current workspace, when several efforts must proceed in parallel on one repository, or when implementation is finished and the change needs merging, rebasing, or splitting for review.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/branch-and-worktree-workflow/SKILL.md"}, {"name": "chief-technology-officer", "summary": "Owns architecture, engineering delivery, infrastructure, data platform, and internal systems", "trigger": "Owns architecture, engineering delivery, infrastructure, data platform, and internal systems. Use this for build-versus-buy calls, technology selection, architectural direction, engineering capacity and delivery risk, technical debt tradeoffs, platform and tooling decisions, or when a technical choice has business consequences that need stating in business terms. Also use to judge whether a technical plan is sound before it is committed to.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/chief-technology-officer/SKILL.md"}, {"name": "cloud-infrastructure", "summary": "Designs and runs cloud infrastructure — environments, infrastructure as code, networking and isolation, scaling, and cost", "trigger": "Designs and runs cloud infrastructure — environments, infrastructure as code, networking and isolation, scaling, and cost. Use this to design a cloud environment, control infrastructure spend, set up environment separation, plan for scale or region failure, or review infrastructure someone configured by hand.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/cloud-infrastructure/SKILL.md"}, {"name": "code-review", "summary": "Conducts and responds to code review — reviewing a change for correctness, design, and risk, and evaluating review feedback received on your own work", "trigger": "Conducts and responds to code review — reviewing a change for correctness, design, and risk, and evaluating review feedback received on your own work. Use this before merging, when asked to review a diff or pull request, when review feedback has arrived and needs acting on, or when feedback seems wrong and needs a reasoned response rather than compliance.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/code-review/SKILL.md"}, {"name": "completion-verification", "summary": "Verifies that work is actually complete before it is claimed to be — running the checks, reading the output, and confirming the original request was…", "trigger": "Verifies that work is actually complete before it is claimed to be — running the checks, reading the output, and confirming the original request was satisfied rather than approximated. Use this before saying something is done, fixed, or passing; before committing or opening a pull request; and whenever a claim of success has not been backed by command output.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/completion-verification/SKILL.md"}, {"name": "implementation-planning", "summary": "Turns a spec or requirement into a written plan a separate session or agent can execute, then drives that plan through review checkpoints", "trigger": "Turns a spec or requirement into a written plan a separate session or agent can execute, then drives that plan through review checkpoints. Use this before touching code on any multi-step task, when work needs handing to someone else, when a task keeps sprawling mid-implementation, or when a plan exists and needs executing in order with verification between steps.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/implementation-planning/SKILL.md"}, {"name": "observability-and-reliability", "summary": "Makes systems debuggable and reliably operable — instrumentation, alerting that is worth waking for, service objectives, and learning from failure", "trigger": "Makes systems debuggable and reliably operable — instrumentation, alerting that is worth waking for, service objectives, and learning from failure. Use this to instrument a service, fix alerting that is ignored, set error budgets or reliability targets, prepare for on-call, or run a blameless post-incident review.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/observability-and-reliability/SKILL.md"}, {"name": "parallel-agent-delivery", "summary": "Splits work across multiple agents or sessions running at once, keeping their surfaces disjoint so results merge cleanly", "trigger": "Splits work across multiple agents or sessions running at once, keeping their surfaces disjoint so results merge cleanly. Use this when facing several independent tasks with no shared state, when a plan has parallelizable steps, when a broad search or audit would be faster fanned out, or when deciding whether work can safely be split at all.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/parallel-agent-delivery/SKILL.md"}, {"name": "prompt-optimizer", "summary": "Turns rough intent or a weak prompt into a reliable one — diagnosing why output is inconsistent, restructuring the instruction, and adapting it acros…", "trigger": "Turns rough intent or a weak prompt into a reliable one — diagnosing why output is inconsistent, restructuring the instruction, and adapting it across models. Use this when a prompt is not producing what was wanted, when output varies run to run, when writing a prompt for a repeated task, when moving a prompt between models, or when someone describes what they want an AI to do and needs it written properly.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/prompt-optimizer/SKILL.md"}, {"name": "release-and-deployment", "summary": "Ships changes safely and often — pipelines, deployment strategies, feature flags, rollback, and database changes", "trigger": "Ships changes safely and often — pipelines, deployment strategies, feature flags, rollback, and database changes. Use this to design a deployment pipeline, reduce release risk, roll out a risky change gradually, plan a schema migration, or work out why releases are infrequent and frightening.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/release-and-deployment/SKILL.md"}, {"name": "skill-authoring", "summary": "Writes and revises agent skills so they trigger at the right moments and give usable instruction when they do", "trigger": "Writes and revises agent skills so they trigger at the right moments and give usable instruction when they do. Use this when creating a new skill, editing an existing one, diagnosing a skill that fires too often or never fires, or reviewing a set of skills for overlap. Also use before adding to a skill library, to check the capability is not already covered.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/skill-authoring/SKILL.md"}, {"name": "solution-architecture", "summary": "Designs system structure and makes architectural decisions defensible — boundaries, coupling, trade-offs, and recording why", "trigger": "Designs system structure and makes architectural decisions defensible — boundaries, coupling, trade-offs, and recording why. Use this to design a new system or major component, choose between architectural options, review an existing design, decide where a boundary belongs, or document an architectural decision so it survives the people who made it.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/solution-architecture/SKILL.md"}, {"name": "solution-exploration", "summary": "Explores the problem and the range of possible approaches before any code is written — clarifying what is actually being asked, surfacing options wit…", "trigger": "Explores the problem and the range of possible approaches before any code is written — clarifying what is actually being asked, surfacing options with their tradeoffs, and converging on one. Use this at the start of any feature, component, or behavior change, when a request is ambiguous, when the first idea is the only idea on the table, or when a design decision needs pressure-testing before commitment.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/solution-exploration/SKILL.md"}, {"name": "systematic-debugging", "summary": "Finds the root cause of a bug, test failure, or unexpected behavior before proposing any fix", "trigger": "Finds the root cause of a bug, test failure, or unexpected behavior before proposing any fix. Use this whenever something is broken and the cause is not yet proven — a failing test, a production error, intermittent behavior, or a symptom that appeared after a change. Also use when a fix has been attempted and did not work, or when the same bug keeps coming back.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/systematic-debugging/SKILL.md"}, {"name": "technical-debt-management", "summary": "Makes technical debt visible and decidable — distinguishing real debt from mess, quantifying its cost, and arguing for remediation in business terms", "trigger": "Makes technical debt visible and decidable — distinguishing real debt from mess, quantifying its cost, and arguing for remediation in business terms. Use this to assess and prioritise debt, decide whether to fix or live with something, justify remediation work to non-engineers, or plan a migration off a system nobody wants to touch.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/technical-debt-management/SKILL.md"}, {"name": "test-driven-development", "summary": "Drives implementation by writing a failing test first, then the smallest code that passes it", "trigger": "Drives implementation by writing a failing test first, then the smallest code that passes it. Use this before writing implementation code for any feature or bugfix, when a bug needs a regression test, when existing code is hard to change safely, or when someone asks whether a change is covered. Also use to decide what is worth testing and what is not.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/technology/skills/test-driven-development/SKILL.md"}]}, {"slug": "security", "title": "Security", "exec": "CISO", "reviewer": true, "skills": [{"name": "access-and-identity", "summary": "Designs and audits who can reach what — authentication, authorization models, privileged access, service credentials, and joiner-mover-leaver process", "trigger": "Designs and audits who can reach what — authentication, authorization models, privileged access, service credentials, and joiner-mover-leaver process. Use this to design a permissions model, run an access review, reduce standing privilege, handle offboarding, set up SSO or MFA, manage service and machine credentials, or diagnose why permissions have sprawled.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/security/skills/access-and-identity/SKILL.md"}, {"name": "chief-information-security-officer", "summary": "Owns the security posture of the organization — architecture, program strategy, risk acceptance, incident command, and the authority to stop work tha…", "trigger": "Owns the security posture of the organization — architecture, program strategy, risk acceptance, incident command, and the authority to stop work that creates unacceptable exposure. Use this for a security strategy or program decision, when a technical choice creates security risk that needs a verdict, when deciding whether to accept or block a risk, when standing up a security function, or when security and delivery priorities conflict and someone has to decide.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/security/skills/chief-information-security-officer/SKILL.md"}, {"name": "incident-response", "summary": "Runs a security incident from detection to closure — triage, containment, investigation, communication, and the review afterward", "trigger": "Runs a security incident from detection to closure — triage, containment, investigation, communication, and the review afterward. Use this when a compromise is suspected or confirmed, when preparing an incident response plan or running an exercise, when deciding whether something is an incident, or when a breach may trigger notification obligations.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/security/skills/incident-response/SKILL.md"}, {"name": "security-architecture-review", "summary": "Reviews a design or change for security before it ships — authentication and authorization, data handling, secrets, dependencies, and the secure-deve…", "trigger": "Reviews a design or change for security before it ships — authentication and authorization, data handling, secrets, dependencies, and the secure-development practices around it. Use this to review an architecture or pull request for security, set secure coding standards, choose or tune SAST and DAST tooling, assess a third-party integration, or decide whether a design is safe to build.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/security/skills/security-architecture-review/SKILL.md"}, {"name": "threat-modeling", "summary": "Identifies what could go wrong in a system before it is built or changed — the assets worth attacking, the entry points, the trust boundaries, and th…", "trigger": "Identifies what could go wrong in a system before it is built or changed — the assets worth attacking, the entry points, the trust boundaries, and the controls that actually address the realistic threats. Use this when designing a feature or system, when a change touches authentication, data handling, payments, or external input, before a security review, or when deciding which security work is worth doing at all.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/security/skills/threat-modeling/SKILL.md"}, {"name": "vulnerability-management", "summary": "Runs the loop from discovering a weakness to confirming it is fixed — scanning, triage, prioritization by real exploitability, remediation tracking,…", "trigger": "Runs the loop from discovering a weakness to confirming it is fixed — scanning, triage, prioritization by real exploitability, remediation tracking, and patch policy. Use this to stand up or fix a vulnerability program, triage scanner output, decide what to fix first, set patch SLAs, handle a disclosure from an outside researcher, or report posture to leadership.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/security/skills/vulnerability-management/SKILL.md"}]}, {"slug": "it-operations", "title": "IT Operations", "exec": "CIO", "reviewer": false, "skills": [{"name": "backup-and-recovery", "summary": "Protects and restores data — backup coverage and scope, retention, immutability against ransomware, and proving restores actually work", "trigger": "Protects and restores data — backup coverage and scope, retention, immutability against ransomware, and proving restores actually work. Use this to design a backup regime, verify restores, plan retention, protect backups from ransomware, or recover from data loss.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/it-operations/skills/backup-and-recovery/SKILL.md"}, {"name": "endpoint-management", "summary": "Manages laptops, desktops and mobile devices — enrolment, configuration, patching, software distribution, and lost or compromised devices", "trigger": "Manages laptops, desktops and mobile devices — enrolment, configuration, patching, software distribution, and lost or compromised devices. Use this to set up device management, standardise builds, roll out software or an OS upgrade, handle a lost device, or bring an unmanaged fleet under control.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/it-operations/skills/endpoint-management/SKILL.md"}, {"name": "identity-lifecycle-administration", "summary": "Executes joiner, mover and leaver processes — provisioning, group membership, access changes on role change, and complete deprovisioning", "trigger": "Executes joiner, mover and leaver processes — provisioning, group membership, access changes on role change, and complete deprovisioning. Use this to set up or fix joiner-mover-leaver, deprovision someone completely, clean up accumulated access, audit group membership, or find accounts that outlived their owners.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/it-operations/skills/identity-lifecycle-administration/SKILL.md"}, {"name": "it-asset-management", "summary": "Tracks hardware and software assets through their life — procurement, ownership, licensing, refresh, and disposal", "trigger": "Tracks hardware and software assets through their life — procurement, ownership, licensing, refresh, and disposal. Use this to build an asset register, prepare for a software audit, plan a refresh cycle, control licence spend, or dispose of equipment safely.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/it-operations/skills/it-asset-management/SKILL.md"}, {"name": "network-administration", "summary": "Designs and operates the corporate network — segmentation, remote access, wireless, DNS and addressing, and diagnosing network problems", "trigger": "Designs and operates the corporate network — segmentation, remote access, wireless, DNS and addressing, and diagnosing network problems. Use this to segment a network, set up or fix remote access, diagnose intermittent connectivity, plan addressing or DNS, or assess whether the network's trust assumptions still hold.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/it-operations/skills/network-administration/SKILL.md"}, {"name": "service-desk", "summary": "Runs the IT service desk — intake, triage, prioritisation, escalation, knowledge, and the metrics that improve service rather than distort it", "trigger": "Runs the IT service desk — intake, triage, prioritisation, escalation, knowledge, and the metrics that improve service rather than distort it. Use this to set up or fix a service desk, design ticket priority and escalation, reduce repeat contacts, structure a knowledge base, or work out why a desk hitting its targets still frustrates everyone.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/it-operations/skills/service-desk/SKILL.md"}, {"name": "systems-administration", "summary": "Runs servers and corporate systems — patching, configuration baselines, change control, capacity, and the routine that prevents incidents", "trigger": "Runs servers and corporate systems — patching, configuration baselines, change control, capacity, and the routine that prevents incidents. Use this to establish a patching cadence, standardise server configuration, plan a maintenance window, decide change control for infrastructure, or clean up systems that have drifted from any known state.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/it-operations/skills/systems-administration/SKILL.md"}]}, {"slug": "product", "title": "Product", "exec": "CPO", "reviewer": false, "skills": [{"name": "brand-identity", "summary": "Defines and applies visual brand — logo usage, palette, typography, imagery direction, and the guidelines that keep expression consistent across prod…", "trigger": "Defines and applies visual brand — logo usage, palette, typography, imagery direction, and the guidelines that keep expression consistent across product and marketing surfaces. Use this to establish a brand from scratch, audit whether an existing brand is being applied consistently, build brand guidelines, or decide how a brand should express itself in an unfamiliar format.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/product/skills/brand-identity/SKILL.md"}, {"name": "chief-product-officer", "summary": "Owns what gets built and why: product strategy, roadmap, discovery, user experience, and the definition of success for each release", "trigger": "Owns what gets built and why: product strategy, roadmap, discovery, user experience, and the definition of success for each release. Use this to decide what to build next, to cut scope, to turn a business goal into a product bet, to judge whether a feature is worth its cost, or when engineering and go-to-market disagree about what a release is for. Also use for roadmap sequencing and for killing work that is not earning its place.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/product/skills/chief-product-officer/SKILL.md"}, {"name": "design-styles", "summary": "Applies a deliberate visual direction to an interface — minimalist editorial, industrial utilitarian, or high-polish commercial — each with its own t…", "trigger": "Applies a deliberate visual direction to an interface — minimalist editorial, industrial utilitarian, or high-polish commercial — each with its own type scale, palette behavior, surface treatment, and motion. Use this when a product needs a point of view rather than defaults, when choosing between visual directions, when an interface reads as generic, or when restyling something without changing its structure.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/product/skills/design-styles/SKILL.md"}, {"name": "design-system", "summary": "Builds and maintains the design system a product is assembled from — tokens for color, type, spacing and elevation, component contracts, and the rule…", "trigger": "Builds and maintains the design system a product is assembled from — tokens for color, type, spacing and elevation, component contracts, and the rules that keep them coherent as the product grows. Use this when starting a new interface, when screens have drifted apart visually, when the same component exists three times in slightly different forms, or when a token or component needs adding without breaking what exists.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/product/skills/design-system/SKILL.md"}, {"name": "interface-craft", "summary": "Raises the visual and interaction quality of an interface — layout, hierarchy, type, spacing, density, and the details that separate a considered pro…", "trigger": "Raises the visual and interaction quality of an interface — layout, hierarchy, type, spacing, density, and the details that separate a considered product from a generic one. Use this when a screen works but looks unfinished or default, when a layout feels crowded or arbitrary, when a page has no clear focal point, or when an interface needs to feel trustworthy rather than merely functional.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/product/skills/interface-craft/SKILL.md"}, {"name": "interface-redesign", "summary": "Upgrades an existing interface to a higher standard without rebuilding it — auditing what is there, identifying what reads as generic or unfinished,…", "trigger": "Upgrades an existing interface to a higher standard without rebuilding it — auditing what is there, identifying what reads as generic or unfinished, and sequencing changes by impact. Use this when a product works but looks dated or default, when a redesign is being considered, when deciding whether to restyle or rebuild, or when a screen needs to look substantially better with limited effort.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/product/skills/interface-redesign/SKILL.md"}, {"name": "presentation-design", "summary": "Designs slide decks, one-pagers, and marketing graphics that carry an argument rather than decorate one", "trigger": "Designs slide decks, one-pagers, and marketing graphics that carry an argument rather than decorate one. Use this to build or fix a pitch deck, board deck, or conference talk; to design a banner, social graphic, or one-pager; or when a deck is dense, unfocused, or being read aloud from the slides.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/product/skills/presentation-design/SKILL.md"}, {"name": "ux-product-auditor", "summary": "Audits a website, app, onboarding flow, or design for usability, conversion, and product problems, tying every finding to a business outcome and a se…", "trigger": "Audits a website, app, onboarding flow, or design for usability, conversion, and product problems, tying every finding to a business outcome and a severity. Use this to review an interface, diagnose low conversion or activation, find where users drop off, get structured product feedback, or decide which UX fixes to ship first. For raising visual quality rather than finding problems, use `interface-craft`.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/product/skills/ux-product-auditor/SKILL.md"}, {"name": "visual-reference-generation", "summary": "Produces design reference imagery before implementation — screen concepts, layout directions, and flows for web or mobile that make a verbal brief co…", "trigger": "Produces design reference imagery before implementation — screen concepts, layout directions, and flows for web or mobile that make a verbal brief concrete enough to argue with. Use this when a brief needs visualizing before anyone builds, when comparing layout directions, when handing a developer a target, or when stakeholders are describing different things with the same words.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/product/skills/visual-reference-generation/SKILL.md"}]}, {"slug": "marketing", "title": "Marketing", "exec": "CMO", "reviewer": false, "skills": [{"name": "behavioral-marketing", "summary": "Applies decision science and cognitive bias research to marketing and product decisions — how people actually choose under uncertainty, and how frami…", "trigger": "Applies decision science and cognitive bias research to marketing and product decisions — how people actually choose under uncertainty, and how framing, defaults, sequencing, and social context change behavior. Use this to diagnose why a well-argued offer is not converting, to structure choices and pricing presentation, to design an experience around how attention and memory work, or to pressure-test whether a persuasion tactic is legitimate or manipulative.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/behavioral-marketing/SKILL.md"}, {"name": "brand-voice", "summary": "Captures how a person or brand actually writes and turns it into reusable voice instructions every other content skill draws from", "trigger": "Captures how a person or brand actually writes and turns it into reusable voice instructions every other content skill draws from. Use this before drafting any content for a new brand or client, when output keeps coming back sounding generic, when several writers need to sound like one, or when a voice needs defining without existing samples to learn from.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/brand-voice/SKILL.md"}, {"name": "chief-content-officer", "summary": "Runs content as an operation — the production pipeline, editorial calendar, repurposing engine, competitive content intelligence, and audits of what…", "trigger": "Runs content as an operation — the production pipeline, editorial calendar, repurposing engine, competitive content intelligence, and audits of what already exists. Use this to build or fix a content production system, plan a calendar, decide how one piece becomes many, rank content ideas by expected impact, or audit an existing library for what to update, consolidate, or retire. For deciding what territory to own and why, use `content-strategy` first.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/chief-content-officer/SKILL.md"}, {"name": "chief-marketing-officer", "summary": "Owns brand, demand generation, content, communications, and how the market understands what the business does", "trigger": "Owns brand, demand generation, content, communications, and how the market understands what the business does. Use this to set marketing strategy, allocate budget across channels, decide positioning and messaging, judge whether a campaign is worth running, diagnose why demand has stalled, or arbitrate between brand-building and short-term acquisition. Also use to decide which marketing work to stop.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/chief-marketing-officer/SKILL.md"}, {"name": "content-strategy", "summary": "Decides what content to make and why — topic territory, format mix, cadence, and how content connects to a business outcome rather than to traffic", "trigger": "Decides what content to make and why — topic territory, format mix, cadence, and how content connects to a business outcome rather than to traffic. Use this to plan a content program, choose topics, build an editorial calendar, decide which formats and platforms to commit to, or diagnose why content is producing audience but not results.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/content-strategy/SKILL.md"}, {"name": "customer-research", "summary": "Plans, runs, and synthesizes customer research — interviews, surveys, win-loss analysis, and message testing — into findings that change decisions", "trigger": "Plans, runs, and synthesizes customer research — interviews, surveys, win-loss analysis, and message testing — into findings that change decisions. Use this when the customer is being guessed at, before positioning or a major launch, when churn or conversion has an unexplained cause, or when a team is arguing from anecdotes. Also use to turn raw interview notes into usable findings.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/customer-research/SKILL.md"}, {"name": "marketing-campaign-planner", "summary": "Designs a coordinated multi-channel campaign or product launch around one story — objective, message, channel sequencing, timeline, assets, and the c…", "trigger": "Designs a coordinated multi-channel campaign or product launch around one story — objective, message, channel sequencing, timeline, assets, and the checklist that gets it out the door. Use this to plan a launch or campaign, sequence a go-to-market push, pressure-test a campaign before committing budget, or turn a product change into a coordinated set of activity. For ongoing channel programs rather than a bounded push, use `marketing-planning`.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/marketing-campaign-planner/SKILL.md"}, {"name": "marketing-copywriting", "summary": "Writes and edits marketing copy for any surface — homepage, product and pricing pages, ads, emails, and collateral — and sharpens existing copy that…", "trigger": "Writes and edits marketing copy for any surface — homepage, product and pricing pages, ads, emails, and collateral — and sharpens existing copy that is not working. Use this to write or rewrite page copy, tighten a draft, fix copy that is vague or feature-led, adapt one message across formats, or review copy before it ships.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/marketing-copywriting/SKILL.md"}, {"name": "marketing-planning", "summary": "Builds the marketing plan of record — objectives, channel mix, budget allocation, sequencing, and the measurement that says whether it worked", "trigger": "Builds the marketing plan of record — objectives, channel mix, budget allocation, sequencing, and the measurement that says whether it worked. Use this for annual or quarterly planning, when budget must be allocated or defended, when marketing activity feels busy but undirected, or when a plan needs pressure-testing before commitment.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/marketing-planning/SKILL.md"}, {"name": "newsletter-writer", "summary": "Writes and edits newsletters and marketing emails people actually open — subject lines, opening, structure, voice, and the conversion turn where ther…", "trigger": "Writes and edits newsletters and marketing emails people actually open — subject lines, opening, structure, voice, and the conversion turn where there is one. Use this to draft or rewrite a newsletter or email, sharpen weak email copy, plan a newsletter's structure and cadence, write a sequence, or repurpose an issue into other formats. For automated lifecycle and SMS programs, use `lifecycle-messaging`.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/newsletter-writer/SKILL.md"}, {"name": "partnership-marketing", "summary": "Builds reach through other people's audiences — co-marketing partnerships, creator and influencer programs, community building, and affiliate arrange…", "trigger": "Builds reach through other people's audiences — co-marketing partnerships, creator and influencer programs, community building, and affiliate arrangements. Use this to find and evaluate partners, structure a joint campaign or creator deal, plan a community strategy, or decide whether a partnership is worth the coordination cost.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/partnership-marketing/SKILL.md"}, {"name": "positioning-and-messaging", "summary": "Establishes what a product is understood to be, for whom, and instead of what — then turns that into the messaging every other surface inherits", "trigger": "Establishes what a product is understood to be, for whom, and instead of what — then turns that into the messaging every other surface inherits. Use this when messaging is inconsistent across channels, when prospects misunderstand what the product does, when entering a new segment, when competitors are being compared against you unfavorably, or before any campaign, launch, or site rewrite.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/positioning-and-messaging/SKILL.md"}, {"name": "public-relations", "summary": "Plans and executes earned media — press strategy, journalist outreach, announcements, commentary, and crisis response", "trigger": "Plans and executes earned media — press strategy, journalist outreach, announcements, commentary, and crisis response. Use this to plan a press push, write a pitch or release, find and approach the right journalists, prepare for an interview, decide whether something is newsworthy, or respond to a story going badly.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/public-relations/SKILL.md"}, {"name": "social-post-craft", "summary": "Writes, structures, and evaluates social posts end to end — hooks, body, formatting for how each platform renders, and a quality check before publish…", "trigger": "Writes, structures, and evaluates social posts end to end — hooks, body, formatting for how each platform renders, and a quality check before publishing. Use this to draft a post, rewrite one that underperformed, turn a longer piece into social content, sharpen an opening, or judge whether a draft is worth publishing.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/social-post-craft/SKILL.md"}, {"name": "video-content", "summary": "Plans and scripts short-form and long-form video, and designs the packaging — titles, thumbnails, and openings — that determines whether it gets watc…", "trigger": "Plans and scripts short-form and long-form video, and designs the packaging — titles, thumbnails, and openings — that determines whether it gets watched. Use this to script a video, plan a series, fix retention or click-through problems, design thumbnail and title concepts, or turn written content into video.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/video-content/SKILL.md"}, {"name": "visual-content", "summary": "Designs and directs the visual assets that carry content — carousels, infographics, quote graphics, diagrams, and social imagery — including the gene…", "trigger": "Designs and directs the visual assets that carry content — carousels, infographics, quote graphics, diagrams, and social imagery — including the generation prompts where they are AI-produced. Use this to turn a written piece into a visual format, design a carousel or infographic, create social graphics, or fix visuals that are not stopping the scroll.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/visual-content/SKILL.md"}, {"name": "youtube-producer", "summary": "Plans, packages, and scripts long-form video for retention and channel growth — idea selection, titles and thumbnails, script structure, and diagnosi…", "trigger": "Plans, packages, and scripts long-form video for retention and channel growth — idea selection, titles and thumbnails, script structure, and diagnosing why a video or channel underperforms. Use this for video ideas, packaging, scripting, a retention teardown, or channel strategy — including when someone describes a topic and wants it turned into something publishable. For short-form and cross-platform video, use `video-content`.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/marketing/skills/youtube-producer/SKILL.md"}]}, {"slug": "demand-generation", "title": "Demand Generation", "exec": "CMO", "reviewer": false, "skills": [{"name": "ai-search-optimization", "summary": "Optimizes for AI assistants and AI-generated answers — being retrievable, being cited, and being represented accurately when a model answers on your…", "trigger": "Optimizes for AI assistants and AI-generated answers — being retrievable, being cited, and being represented accurately when a model answers on your behalf. Use this when traffic is shifting from links to AI answers, when a brand is misrepresented or absent in AI responses, when planning content for retrieval rather than ranking, or when deciding how AI search changes an existing SEO program.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/ai-search-optimization/SKILL.md"}, {"name": "app-store-optimization", "summary": "Improves visibility and conversion in the App Store and Google Play — metadata, keywords, screenshots, ratings, and the listing experience that turns…", "trigger": "Improves visibility and conversion in the App Store and Google Play — metadata, keywords, screenshots, ratings, and the listing experience that turns an impression into an install. Use this to audit or optimize an app listing, plan a launch listing, diagnose poor install conversion, or improve store search visibility.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/app-store-optimization/SKILL.md"}, {"name": "experimentation", "summary": "Designs, runs, and reads A/B tests and growth experiments — hypothesis, sample size, duration, and honest interpretation", "trigger": "Designs, runs, and reads A/B tests and growth experiments — hypothesis, sample size, duration, and honest interpretation. Use this to plan a test, judge whether a result is real, build an experimentation program, decide what to test next, or diagnose why tests keep producing inconclusive or non-replicating results.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/experimentation/SKILL.md"}, {"name": "landing-page-cro-expert", "summary": "Audits and rewrites landing pages, homepages, and sales pages to increase conversion — diagnosing why a page is not converting, rewriting headlines,…", "trigger": "Audits and rewrites landing pages, homepages, and sales pages to increase conversion — diagnosing why a page is not converting, rewriting headlines, hero copy and calls to action, and prioritizing which changes to test first. Use this when a page underperforms, when someone pastes a URL or screenshot asking what is wrong, when writing a new page, or when deciding which conversion changes are worth testing.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/landing-page-cro-expert/SKILL.md"}, {"name": "lead-capture", "summary": "Converts anonymous traffic into known contacts — lead magnets, gated content, free tools, popups, and the forms behind them", "trigger": "Converts anonymous traffic into known contacts — lead magnets, gated content, free tools, popups, and the forms behind them. Use this to design or improve a lead magnet, plan a free tool, add or fix popups and overlays, improve form conversion, or decide what is worth gating and what should stay open.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/lead-capture/SKILL.md"}, {"name": "lifecycle-messaging", "summary": "Designs automated email and SMS programs — welcome and onboarding sequences, nurture, re-engagement, transactional messaging, and the timing and segm…", "trigger": "Designs automated email and SMS programs — welcome and onboarding sequences, nurture, re-engagement, transactional messaging, and the timing and segmentation behind them. Use this to build or fix an email sequence, plan lifecycle automation, improve open or click performance, set up SMS flows, or decide what messages a customer should receive and when.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/lifecycle-messaging/SKILL.md"}, {"name": "listing-distribution", "summary": "Gets a product listed where buyers and crawlers look — directories, marketplaces, review sites, comparison pages, and aggregators", "trigger": "Gets a product listed where buyers and crawlers look — directories, marketplaces, review sites, comparison pages, and aggregators. Use this to plan a submission push, choose which directories are worth the effort, prepare listing assets, build comparison and alternative pages, or manage presence on review platforms.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/listing-distribution/SKILL.md"}, {"name": "marketing-analytics", "summary": "Sets up, audits, and reports on marketing measurement — tracking plans, event schemas, attribution models, and the dashboards built on them", "trigger": "Sets up, audits, and reports on marketing measurement — tracking plans, event schemas, attribution models, and the dashboards built on them. Use this to instrument a site or product, audit tracking nobody trusts, choose or interpret an attribution model, build reporting that answers a specific question, or reconcile numbers that disagree between tools.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/marketing-analytics/SKILL.md"}, {"name": "paid-advertising", "summary": "Plans, runs, and optimizes paid acquisition across search, social, and display — account structure, targeting, creative, bidding, budget, and the ana…", "trigger": "Plans, runs, and optimizes paid acquisition across search, social, and display — account structure, targeting, creative, bidding, budget, and the analysis that says whether to scale or stop. Use this to set up or restructure campaigns, write and iterate ad creative, diagnose rising costs or falling performance, decide budget allocation, or judge whether a channel is working.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/paid-advertising/SKILL.md"}, {"name": "programmatic-seo", "summary": "Builds large sets of search-targeted pages from a template and a dataset — the location, comparison, integration, and use-case pages that capture lon…", "trigger": "Builds large sets of search-targeted pages from a template and a dataset — the location, comparison, integration, and use-case pages that capture long-tail demand at scale. Use this when there is a repeating query pattern with real volume, when a dataset could answer many similar searches, or to judge whether a programmatic approach is viable before building it.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/programmatic-seo/SKILL.md"}, {"name": "seo-strategy", "summary": "Audits and improves organic search performance — technical health, site architecture, internal linking, structured data, and the content decisions th…", "trigger": "Audits and improves organic search performance — technical health, site architecture, internal linking, structured data, and the content decisions that determine what can rank. Use this to run an SEO audit, diagnose why pages are not ranking or were deindexed, plan a site's URL and navigation structure, add structured data, or prioritize which SEO fixes are worth doing.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/demand-generation/skills/seo-strategy/SKILL.md"}]}, {"slug": "revenue", "title": "Revenue", "exec": "CRO", "reviewer": false, "skills": [{"name": "activation", "summary": "Gets new users from signup to first real value — signup flow, onboarding, time-to-value, and the early experience that determines whether someone bec…", "trigger": "Gets new users from signup to first real value — signup flow, onboarding, time-to-value, and the early experience that determines whether someone becomes a user or a lapsed account. Use this to design or fix signup and onboarding, diagnose why signups do not convert to active use, reduce time-to-value, or decide what a new user must accomplish first.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/revenue/skills/activation/SKILL.md"}, {"name": "chief-revenue-officer", "summary": "Owns the revenue engine end to end: sales, monetization, pricing, customer success, retention, and partnerships", "trigger": "Owns the revenue engine end to end: sales, monetization, pricing, customer success, retention, and partnerships. Use this for pricing and packaging decisions, sales strategy and coverage, forecast and pipeline health, churn and expansion, partner and channel strategy, or when marketing-sourced demand is not converting. Also use to decide which segments to pursue and which to decline.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/revenue/skills/chief-revenue-officer/SKILL.md"}, {"name": "outbound-prospecting", "summary": "Finds, qualifies, and reaches prospects through cold outreach — list building, qualification criteria, cold email and multi-channel sequences, and th…", "trigger": "Finds, qualifies, and reaches prospects through cold outreach — list building, qualification criteria, cold email and multi-channel sequences, and the follow-up that actually gets replies. Use this to build a prospect list, write cold outreach, fix a sequence that is not getting responses, define qualification criteria, or decide whether a segment is worth pursuing.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/revenue/skills/outbound-prospecting/SKILL.md"}, {"name": "pricing-and-packaging", "summary": "Sets price, structures packages and tiers, and designs the monetization surfaces that carry them — upgrade paths, paywalls, and offer construction", "trigger": "Sets price, structures packages and tiers, and designs the monetization surfaces that carry them — upgrade paths, paywalls, and offer construction. Use this to set or change pricing, design or restructure tiers, choose a pricing metric, build an offer, design upgrade prompts and paywalls, or evaluate whether a pricing change is safe to make.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/revenue/skills/pricing-and-packaging/SKILL.md"}, {"name": "referral-programs", "summary": "Designs and improves referral, affiliate, and word-of-mouth programs — incentive structure, mechanics, timing, and fraud control", "trigger": "Designs and improves referral, affiliate, and word-of-mouth programs — incentive structure, mechanics, timing, and fraud control. Use this to build a referral or affiliate program, diagnose one that is not producing, decide what incentive to offer, or judge whether referral is a realistic channel for a product.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/revenue/skills/referral-programs/SKILL.md"}, {"name": "retention", "summary": "Diagnoses and reduces churn — cancellation flows, save offers, failed-payment recovery, at-risk detection, and the product and service causes underne…", "trigger": "Diagnoses and reduces churn — cancellation flows, save offers, failed-payment recovery, at-risk detection, and the product and service causes underneath. Use this when churn is rising or unexplained, to design a cancellation or win-back flow, to recover involuntary churn, to identify at-risk accounts before they leave, or to decide whether a retention problem is a product problem.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/revenue/skills/retention/SKILL.md"}, {"name": "revenue-operations", "summary": "Runs the mechanics of the revenue engine — lead lifecycle definitions, routing, CRM hygiene, forecasting process, pipeline reporting, and the marketi…", "trigger": "Runs the mechanics of the revenue engine — lead lifecycle definitions, routing, CRM hygiene, forecasting process, pipeline reporting, and the marketing-to-sales handoff. Use this to fix a broken handoff, define lifecycle stages, improve forecast accuracy, clean up CRM data, design territory or routing rules, or diagnose why pipeline numbers are not trusted.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/revenue/skills/revenue-operations/SKILL.md"}, {"name": "sales-enablement", "summary": "Builds what a sales team needs to sell — pitch decks, one-pagers, objection handling, competitive battlecards, demo scripts, and case studies", "trigger": "Builds what a sales team needs to sell — pitch decks, one-pagers, objection handling, competitive battlecards, demo scripts, and case studies. Use this to create or fix sales collateral, prepare for a competitive deal, build a demo flow, document objection responses, or diagnose why a pitch is not converting.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/revenue/skills/sales-enablement/SKILL.md"}]}, {"slug": "finance", "title": "Finance", "exec": "CFO", "reviewer": false, "skills": [{"name": "budgeting-and-forecasting", "summary": "Runs the planning cycle — annual budget, rolling forecast, consolidation of business unit inputs, and the variance analysis that explains actuals aga…", "trigger": "Runs the planning cycle — annual budget, rolling forecast, consolidation of business unit inputs, and the variance analysis that explains actuals against plan. Use this to build or challenge a budget, run a forecast cycle, consolidate departmental submissions, explain why results diverged from plan, or improve forecast accuracy.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/finance/skills/budgeting-and-forecasting/SKILL.md"}, {"name": "capital-allocation", "summary": "Evaluates where to spend limited capital — investment appraisal, hurdle rates, payback, and comparing proposals that are not alike", "trigger": "Evaluates where to spend limited capital — investment appraisal, hurdle rates, payback, and comparing proposals that are not alike. Use this to evaluate an investment or major purchase, compare competing funding requests, set a hurdle rate, decide between building and buying, or review whether past investments delivered what was claimed.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/finance/skills/capital-allocation/SKILL.md"}, {"name": "chief-financial-officer", "summary": "Owns the financial position: planning, budgeting, forecasting, unit economics, cash, and the numbers the business is run and reported on", "trigger": "Owns the financial position: planning, budgeting, forecasting, unit economics, cash, and the numbers the business is run and reported on. Use this to build or challenge a budget, model a decision's financial consequence, assess unit economics or runway, evaluate an investment or spend request, set financial controls, or when a plan's numbers do not reconcile. Also use to decide whether the business can afford something.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/finance/skills/chief-financial-officer/SKILL.md"}, {"name": "financial-modeling", "summary": "Builds and stress-tests financial models for forecasting, scenario planning, and decision support — revenue build, cost structure, driver logic, and…", "trigger": "Builds and stress-tests financial models for forecasting, scenario planning, and decision support — revenue build, cost structure, driver logic, and the sensitivities that show where a plan breaks. Use this to model a decision's financial consequence, build a forecast or long-range plan, evaluate an investment or hire, or pressure-test someone else's model before relying on it.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/finance/skills/financial-modeling/SKILL.md"}, {"name": "financial-reporting-and-close", "summary": "Runs the period-end close and produces reporting — close calendar, reconciliations, accruals, variance analysis, and reporting that gets read", "trigger": "Runs the period-end close and produces reporting — close calendar, reconciliations, accruals, variance analysis, and reporting that gets read. Use this to shorten or stabilise a monthly close, design a close checklist, investigate a variance, structure management reporting, or work out why the numbers keep changing after close.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/finance/skills/financial-reporting-and-close/SKILL.md"}, {"name": "internal-controls-and-audit", "summary": "Designs and tests controls over financial reporting — segregation of duties, approval limits, evidence, and preparing for audit", "trigger": "Designs and tests controls over financial reporting — segregation of duties, approval limits, evidence, and preparing for audit. Use this to design controls for a process, prepare for an external audit, respond to an audit finding, set approval thresholds, or assess where a small team's segregation of duties is genuinely broken.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/finance/skills/internal-controls-and-audit/SKILL.md"}, {"name": "revenue-recognition", "summary": "Determines when and how revenue is recognised — performance obligations, contract terms that change the answer, and the deal structures that create a…", "trigger": "Determines when and how revenue is recognised — performance obligations, contract terms that change the answer, and the deal structures that create accounting problems. Use this to work out how a contract should be recognised, review a non-standard deal before it is signed, understand deferred revenue, or spot terms that would delay or reverse recognition.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/finance/skills/revenue-recognition/SKILL.md"}, {"name": "treasury-and-liquidity", "summary": "Manages cash and liquidity — cash forecasting, runway, working capital, banking structure, and currency and counterparty exposure", "trigger": "Manages cash and liquidity — cash forecasting, runway, working capital, banking structure, and currency and counterparty exposure. Use this to build a cash forecast, extend runway, improve working capital, decide where cash should sit, or assess exposure to a bank, currency, or customer concentration.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/finance/skills/treasury-and-liquidity/SKILL.md"}, {"name": "unit-economics", "summary": "Establishes whether the business makes money on each customer or unit — contribution margin, acquisition cost, payback period, lifetime value, and th…", "trigger": "Establishes whether the business makes money on each customer or unit — contribution margin, acquisition cost, payback period, lifetime value, and the cohort behavior underneath. Use this to assess whether growth is profitable, evaluate a channel or segment, support a pricing decision, judge how fast the business can afford to grow, or diagnose why revenue growth is not producing profit.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/finance/skills/unit-economics/SKILL.md"}]}, {"slug": "operations", "title": "Operations", "exec": "COO", "reviewer": false, "skills": [{"name": "business-continuity-and-resilience", "summary": "Plans for operating through disruption — impact analysis, recovery objectives, continuity plans, and the exercises that prove they work", "trigger": "Plans for operating through disruption — impact analysis, recovery objectives, continuity plans, and the exercises that prove they work. Use this to run a business impact analysis, set RTO and RPO, write or test a continuity plan, prepare for a supplier or site failure, or answer a customer's resilience questionnaire.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/operations/skills/business-continuity-and-resilience/SKILL.md"}, {"name": "capacity-and-demand-planning", "summary": "Matches operational capacity to expected demand — forecasting load, sizing teams and systems, managing queues, and deciding when to add capacity", "trigger": "Matches operational capacity to expected demand — forecasting load, sizing teams and systems, managing queues, and deciding when to add capacity. Use this to plan staffing for expected volume, diagnose a queue that keeps growing, size support or fulfilment capacity, or decide whether a bottleneck needs more capacity or better flow.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/operations/skills/capacity-and-demand-planning/SKILL.md"}, {"name": "chief-operating-officer", "summary": "Owns execution: how work actually gets done across the organization, including process, program management, capacity, vendors, supply chain, and serv…", "trigger": "Owns execution: how work actually gets done across the organization, including process, program management, capacity, vendors, supply chain, and service delivery. Use this when execution is the problem rather than strategy, to design or fix a process, to resolve cross-functional handoff failures, to plan capacity, to assess delivery risk, or when the same failure keeps recurring. Also use to decide whether to build, hire, or outsource a capability.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/operations/skills/chief-operating-officer/SKILL.md"}, {"name": "process-design", "summary": "Designs, documents, and fixes operational processes — mapping the current state, finding where work actually stalls, redesigning the flow, and buildi…", "trigger": "Designs, documents, and fixes operational processes — mapping the current state, finding where work actually stalls, redesigning the flow, and building controls that hold. Use this when the same failure keeps recurring, when a handoff between teams is unreliable, when onboarding a repeated task, when work takes far longer than the work itself, or when deciding whether to automate, standardize, or eliminate a process.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/operations/skills/process-design/SKILL.md"}, {"name": "quality-management", "summary": "Builds quality into operations — defining standards, catching defects at the right point, root cause analysis, and continuous improvement", "trigger": "Builds quality into operations — defining standards, catching defects at the right point, root cause analysis, and continuous improvement. Use this to reduce a defect or error rate, design quality controls into a process, run a root cause analysis, respond to a customer quality complaint, or set up quality metrics that drive behaviour.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/operations/skills/quality-management/SKILL.md"}, {"name": "service-level-management", "summary": "Defines and manages service levels — setting targets that reflect what customers need, measuring honestly, and handling breaches", "trigger": "Defines and manages service levels — setting targets that reflect what customers need, measuring honestly, and handling breaches. Use this to write or negotiate an SLA, decide what to measure and at what threshold, respond to a missed service level, or work out why a service that meets its targets still has unhappy customers.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/operations/skills/service-level-management/SKILL.md"}, {"name": "supply-chain-and-logistics", "summary": "Manages the flow of goods and inputs — sourcing, inventory, lead times, fulfilment, and supply risk", "trigger": "Manages the flow of goods and inputs — sourcing, inventory, lead times, fulfilment, and supply risk. Use this to reduce stockouts or excess inventory, plan for a supplier failure, decide reorder points and safety stock, improve fulfilment reliability, or assess concentration risk in a supply base.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/operations/skills/supply-chain-and-logistics/SKILL.md"}, {"name": "vendor-management", "summary": "Selects, contracts, and manages suppliers and vendors — requirements, evaluation, negotiation support, onboarding, performance management, and exit", "trigger": "Selects, contracts, and manages suppliers and vendors — requirements, evaluation, negotiation support, onboarding, performance management, and exit. Use this to choose a vendor, run a selection process, structure a service agreement's operational terms, manage an underperforming supplier, plan an exit or migration, or assess concentration and continuity risk.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/operations/skills/vendor-management/SKILL.md"}]}, {"slug": "pmo", "title": "Programme Management Office", "exec": "EPMO / COO", "reviewer": false, "skills": [{"name": "benefits-realization", "summary": "Ensures projects deliver the value they were approved on — defining measurable benefits, baselining, tracking after delivery, and honest post-impleme…", "trigger": "Ensures projects deliver the value they were approved on — defining measurable benefits, baselining, tracking after delivery, and honest post-implementation review. Use this to define benefits for a business case, set a baseline, track whether value actually landed, or run a post-implementation review that produces something useful.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/pmo/skills/benefits-realization/SKILL.md"}, {"name": "change-and-adoption", "summary": "Gets people to actually use what was delivered — stakeholder analysis, communication, training, resistance, and measuring adoption", "trigger": "Gets people to actually use what was delivered — stakeholder analysis, communication, training, resistance, and measuring adoption. Use this to plan a rollout, recover an implementation nobody is using, handle resistance to a change, sequence communications, or work out why a technically successful project changed nothing.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/pmo/skills/change-and-adoption/SKILL.md"}, {"name": "dependency-and-risk-management", "summary": "Manages delivery risk and cross-team dependencies — identifying, sizing, mitigating and escalating what could stop the work", "trigger": "Manages delivery risk and cross-team dependencies — identifying, sizing, mitigating and escalating what could stop the work. Use this to build a risk register that gets used, manage dependencies between teams, decide what to escalate and when, or work out why the same risks keep materialising unmanaged.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/pmo/skills/dependency-and-risk-management/SKILL.md"}, {"name": "portfolio-governance", "summary": "Governs the portfolio of work — intake, prioritisation, stage gates, resource contention, and stopping things", "trigger": "Governs the portfolio of work — intake, prioritisation, stage gates, resource contention, and stopping things. Use this to set up intake and prioritisation, run a stage gate, decide between competing initiatives, resolve resource contention across projects, or work out why everything is in flight and nothing is finishing.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/pmo/skills/portfolio-governance/SKILL.md"}, {"name": "program-management", "summary": "Plans and drives cross-functional programs to delivery — scope, sequencing, dependencies, status, risk, and the escalations that keep work moving", "trigger": "Plans and drives cross-functional programs to delivery — scope, sequencing, dependencies, status, risk, and the escalations that keep work moving. Use this to run a multi-team initiative, recover a program that is slipping, build a delivery plan with dependencies, structure status reporting, or diagnose why cross-team work keeps missing dates.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/pmo/skills/program-management/SKILL.md"}, {"name": "project-delivery", "summary": "Plans and delivers a single project — scope, estimation, scheduling, critical path, tracking, and recovering when it slips", "trigger": "Plans and delivers a single project — scope, estimation, scheduling, critical path, tracking, and recovering when it slips. Use this to plan a project, build or challenge a schedule, estimate credibly, track progress meaningfully, or recover a project that is late.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/pmo/skills/project-delivery/SKILL.md"}]}, {"slug": "customer-experience", "title": "Customer Experience", "exec": "CCO", "reviewer": false, "skills": [{"name": "chief-customer-officer", "summary": "Owns the customer's experience after the sale — support, success, escalation, and the feedback loop back into product", "trigger": "Owns the customer's experience after the sale — support, success, escalation, and the feedback loop back into product. Use this for a decision spanning support and product, when service quality and cost are in tension, when deciding what to staff or automate, when a customer relationship is at risk above the account-manager level, or when nobody owns a recurring customer problem.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/customer-experience/skills/chief-customer-officer/SKILL.md"}, {"name": "escalation-management", "summary": "Handles customer situations that have exceeded normal support — severity assessment, incident communication, executive escalation, and recovering a r…", "trigger": "Handles customer situations that have exceeded normal support — severity assessment, incident communication, executive escalation, and recovering a relationship after a failure. Use this when a customer issue is escalating or has gone to leadership, during a customer-affecting outage, when a major account is at risk, when a relationship needs repairing after a failure, or to design the escalation path itself.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/customer-experience/skills/escalation-management/SKILL.md"}, {"name": "self-service-and-knowledge", "summary": "Builds the help centre, in-product guidance, and knowledge base that let customers resolve problems without contacting anyone — content, findability,…", "trigger": "Builds the help centre, in-product guidance, and knowledge base that let customers resolve problems without contacting anyone — content, findability, maintenance, and deflection measurement. Use this to build or fix a help centre, reduce support volume, write documentation for customers, improve findability, or decide what deserves a help article versus a product fix.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/customer-experience/skills/self-service-and-knowledge/SKILL.md"}, {"name": "support-operations", "summary": "Designs and runs the support function — channels, queues, routing, staffing, service levels, quality, and the metrics that show whether it is working", "trigger": "Designs and runs the support function — channels, queues, routing, staffing, service levels, quality, and the metrics that show whether it is working. Use this to set up or fix support operations, choose channels, size a team, set or renegotiate service levels, reduce cost per contact, diagnose long queues or poor quality, or decide what to automate.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/customer-experience/skills/support-operations/SKILL.md"}, {"name": "voice-of-customer", "summary": "Builds the loop from what customers say to what gets changed — collecting feedback, distinguishing signal from noise, routing it to owners, and closi…", "trigger": "Builds the loop from what customers say to what gets changed — collecting feedback, distinguishing signal from noise, routing it to owners, and closing the loop back to the customer. Use this to set up a feedback programme, design or interpret CSAT/NPS, decide what customer feedback deserves action, get product to act on recurring issues, or diagnose why feedback is collected but nothing changes.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/customer-experience/skills/voice-of-customer/SKILL.md"}]}, {"slug": "data-analytics", "title": "Data & Analytics", "exec": "CDO", "reviewer": false, "skills": [{"name": "ai-ml-governance", "summary": "Governs models and AI systems in production — intended use, evaluation, monitoring, human oversight, documentation, and the decision to deploy or ret…", "trigger": "Governs models and AI systems in production — intended use, evaluation, monitoring, human oversight, documentation, and the decision to deploy or retire. Use this before deploying a model or AI feature, when defining evaluation criteria, when a model's behavior has drifted, when assessing AI risk or regulatory exposure, or when deciding whether an AI system is fit for a consequential decision.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/data-analytics/skills/ai-ml-governance/SKILL.md"}, {"name": "business-intelligence", "summary": "Builds reporting and self-serve analytics that people actually use — metric trees, dashboard design, distribution, and the discipline that stops dash…", "trigger": "Builds reporting and self-serve analytics that people actually use — metric trees, dashboard design, distribution, and the discipline that stops dashboards proliferating. Use this to build a dashboard or report, design a metrics framework, set up self-serve analytics, decide what to measure, or diagnose why reporting exists but nobody uses it or trusts it.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/data-analytics/skills/business-intelligence/SKILL.md"}, {"name": "chief-data-officer", "summary": "Owns data as an asset — governance, quality, the warehouse and semantic layer, analytics capability, and the governance of models built on top", "trigger": "Owns data as an asset — governance, quality, the warehouse and semantic layer, analytics capability, and the governance of models built on top. Use this for a decision about how data is collected, stored, defined, or shared; when numbers disagree between teams; when deciding what to build in-house versus buy; when standing up a data function; or when an AI or model decision needs governance rather than engineering.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/data-analytics/skills/chief-data-officer/SKILL.md"}, {"name": "data-engineering", "summary": "Builds and operates data pipelines — ingestion, transformation, orchestration, quality testing, and reliability of data delivery", "trigger": "Builds and operates data pipelines — ingestion, transformation, orchestration, quality testing, and reliability of data delivery. Use this to design or debug a pipeline, decide batch versus streaming, add data quality checks, handle late or duplicate data, or work out why a dashboard's numbers changed without anyone changing the dashboard.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/data-analytics/skills/data-engineering/SKILL.md"}, {"name": "data-governance", "summary": "Establishes ownership, definitions, quality, access, and lineage for the organization's data", "trigger": "Establishes ownership, definitions, quality, access, and lineage for the organization's data. Use this when metrics disagree between teams, when nobody knows which dataset is authoritative, when setting up data ownership or access policy, when data quality is unreliable, or before opening a dataset to a wider audience.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/data-analytics/skills/data-governance/SKILL.md"}, {"name": "data-modeling", "summary": "Designs the warehouse and semantic layer — source-to-mart structure, dimensional modeling, grain, slowly changing dimensions, and the metric layer an…", "trigger": "Designs the warehouse and semantic layer — source-to-mart structure, dimensional modeling, grain, slowly changing dimensions, and the metric layer analytics reads through. Use this to design or restructure a warehouse, model a new source, decide on grain or table structure, build a semantic or metric layer, or diagnose why queries are slow, wrong, or impossible to write.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/data-analytics/skills/data-modeling/SKILL.md"}]}, {"slug": "corporate-strategy", "title": "Corporate Strategy", "exec": "CSO", "reviewer": false, "skills": [{"name": "chief-strategy-officer", "summary": "Owns where the business plays and how it wins over a multi-year horizon — portfolio choices, corporate development, strategic partnerships, and plann…", "trigger": "Owns where the business plays and how it wins over a multi-year horizon — portfolio choices, corporate development, strategic partnerships, and planning under uncertainty. Use this for a decision about which markets or businesses to be in, whether to build, buy, or partner, how to allocate capital across business lines, or when a long-horizon bet needs framing. Distinct from `chief-executive`, which arbitrates present-quarter conflicts.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/corporate-strategy/skills/chief-strategy-officer/SKILL.md"}, {"name": "mergers-and-acquisitions", "summary": "Runs corporate development — deal thesis, target screening, valuation framing, diligence, and integration planning", "trigger": "Runs corporate development — deal thesis, target screening, valuation framing, diligence, and integration planning. Use this when considering an acquisition or being approached about one, when evaluating build-versus-buy at company scale, when running or reviewing diligence, or when planning how an acquired business will actually be integrated.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/corporate-strategy/skills/mergers-and-acquisitions/SKILL.md"}, {"name": "portfolio-strategy", "summary": "Decides where capital and attention go across business lines, products, and markets — what to fund, hold, harvest, or exit, and on what evidence", "trigger": "Decides where capital and attention go across business lines, products, and markets — what to fund, hold, harvest, or exit, and on what evidence. Use this to allocate budget across businesses, evaluate whether a product line should continue, decide market entry or exit, structure a portfolio review, or when several initiatives compete for the same limited investment.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/corporate-strategy/skills/portfolio-strategy/SKILL.md"}, {"name": "scenario-planning", "summary": "Plans under genuine uncertainty — building scenarios, identifying which assumptions are load-bearing, setting early-warning indicators, and stress-te…", "trigger": "Plans under genuine uncertainty — building scenarios, identifying which assumptions are load-bearing, setting early-warning indicators, and stress-testing a plan against futures rather than forecasting one. Use this when a decision depends on something unknowable, when a plan assumes conditions that may not hold, before a large irreversible commitment, or when a market, regulatory, or technology shift could invalidate the strategy.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/corporate-strategy/skills/scenario-planning/SKILL.md"}, {"name": "strategic-alliances", "summary": "Structures partnerships that change what the business can do — technology integrations, channel and reseller arrangements, joint ventures, and OEM re…", "trigger": "Structures partnerships that change what the business can do — technology integrations, channel and reseller arrangements, joint ventures, and OEM relationships. Use this to evaluate or structure a strategic partnership, decide between partnering and building, negotiate commercial terms of an alliance, or diagnose a partnership that is signed but not producing. For audience-borrowing partnerships, use `marketing:partnership-marketing`.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/corporate-strategy/skills/strategic-alliances/SKILL.md"}]}, {"slug": "people", "title": "People", "exec": "CHRO", "reviewer": false, "skills": [{"name": "chief-human-resources-officer", "summary": "Owns the organization itself: org design, hiring, performance, compensation, development, culture, and employee relations", "trigger": "Owns the organization itself: org design, hiring, performance, compensation, development, culture, and employee relations. Use this to design or restructure a team, plan hiring, write a role or leveling definition, handle a performance or compensation question, diagnose why a team is underperforming for non-technical reasons, or assess the people risk in a plan. Also use for onboarding design and retention of key staff.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/people/skills/chief-human-resources-officer/SKILL.md"}, {"name": "compensation-and-leveling", "summary": "Builds and maintains the leveling framework and pay structure — level definitions, salary bands, benchmarking, pay equity, and how raises and promoti…", "trigger": "Builds and maintains the leveling framework and pay structure — level definitions, salary bands, benchmarking, pay equity, and how raises and promotions are decided. Use this to design or revise leveling, set or adjust salary bands, benchmark against market, handle a compensation request or counteroffer, run a review cycle, or diagnose pay compression and equity issues.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/people/skills/compensation-and-leveling/SKILL.md"}, {"name": "employee-relations", "summary": "Handles the difficult human situations — grievances, complaints, investigations, conflict, and separations conducted properly", "trigger": "Handles the difficult human situations — grievances, complaints, investigations, conflict, and separations conducted properly. Use this to respond to a complaint or grievance, structure an investigation, handle a conflict between colleagues, prepare for a difficult conversation, or work out what a manager can and cannot do in a given situation.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/people/skills/employee-relations/SKILL.md"}, {"name": "hiring-and-interviewing", "summary": "Designs and runs hiring — role definition, sourcing, interview loop design, structured evaluation, and the decision itself", "trigger": "Designs and runs hiring — role definition, sourcing, interview loop design, structured evaluation, and the decision itself. Use this to open a role, write a job description or scorecard, design an interview process, prepare interview questions, calibrate a hiring decision, or diagnose why a hiring process produces poor outcomes.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/people/skills/hiring-and-interviewing/SKILL.md"}, {"name": "learning-and-development", "summary": "Builds capability — skills gaps, career frameworks, training that transfers to the job, and internal mobility", "trigger": "Builds capability — skills gaps, career frameworks, training that transfers to the job, and internal mobility. Use this to design a career ladder, close a capability gap, decide whether to build or hire a skill, structure onboarding into a role, or work out why training keeps failing to change anything.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/people/skills/learning-and-development/SKILL.md"}, {"name": "onboarding-and-offboarding", "summary": "Designs the joining and leaving experience — first-day readiness, ramp to productivity, knowledge capture, and clean exits", "trigger": "Designs the joining and leaving experience — first-day readiness, ramp to productivity, knowledge capture, and clean exits. Use this to design or fix onboarding, shorten time to productivity, structure a leaver process, capture knowledge before someone leaves, or coordinate the access and asset steps around a joiner or leaver.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/people/skills/onboarding-and-offboarding/SKILL.md"}, {"name": "org-design", "summary": "Designs how an organization is structured — reporting lines, team boundaries, spans and layers, role definition, and workforce planning against the s…", "trigger": "Designs how an organization is structured — reporting lines, team boundaries, spans and layers, role definition, and workforce planning against the strategy. Use this to structure a new team, restructure an existing one, resolve unclear ownership between teams, plan headcount, or diagnose why a team underperforms for structural rather than individual reasons.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/people/skills/org-design/SKILL.md"}, {"name": "performance-management", "summary": "Runs performance systems that change behaviour — expectations, feedback, review cycles, calibration, and handling underperformance", "trigger": "Runs performance systems that change behaviour — expectations, feedback, review cycles, calibration, and handling underperformance. Use this to design or fix a review process, run calibration, write or coach on feedback, address sustained underperformance, or work out why reviews consume weeks and change nothing.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/people/skills/performance-management/SKILL.md"}, {"name": "workforce-planning", "summary": "Plans the shape and size of the workforce — demand for roles, build-versus-buy, attrition, and sequencing hiring against budget", "trigger": "Plans the shape and size of the workforce — demand for roles, build-versus-buy, attrition, and sequencing hiring against budget. Use this to build a hiring plan, decide which roles to open and in what order, model attrition and backfill, plan for a growth or contraction scenario, or connect headcount plans to the budget.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/people/skills/workforce-planning/SKILL.md"}]}, {"slug": "legal-risk", "title": "Legal & Risk", "exec": "CLO / CCO", "reviewer": true, "skills": [{"name": "chief-legal-and-risk-officer", "summary": "Owns legal, contracts, intellectual property, regulatory compliance, privacy, security governance, enterprise risk, and audit readiness", "trigger": "Owns legal, contracts, intellectual property, regulatory compliance, privacy, security governance, enterprise risk, and audit readiness. Use this to review a contract or commitment, assess regulatory or privacy exposure, evaluate an IP or licensing question, judge the risk in a business decision, prepare for an audit or certification, or when a plan may create obligations the business cannot meet. Also use to decide whether a risk should be accepted, mitigated, or refused.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/legal-risk/skills/chief-legal-and-risk-officer/SKILL.md"}, {"name": "contract-review", "summary": "Reviews and negotiates commercial agreements — MSAs, SOWs, order forms, NDAs, vendor and data-processing agreements — identifying material risk, prop…", "trigger": "Reviews and negotiates commercial agreements — MSAs, SOWs, order forms, NDAs, vendor and data-processing agreements — identifying material risk, proposing positions, and recommending a path rather than listing issues. Use this to review a contract before signature, prepare a negotiation position, build fallback positions and approval thresholds, or assess exposure in terms already agreed.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/legal-risk/skills/contract-review/SKILL.md"}, {"name": "corporate-governance", "summary": "Maintains the corporate record and the governance machinery — entity records, board and committee support, resolutions and minutes, delegations of au…", "trigger": "Maintains the corporate record and the governance machinery — entity records, board and committee support, resolutions and minutes, delegations of authority, insurance, and business continuity. Use this to prepare board or committee materials, record a decision that needs to be minuted, set or check approval authority, review insurance and continuity coverage, establish a retention policy, or work out where a responsibility belongs when it falls between functions.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/legal-risk/skills/corporate-governance/SKILL.md"}, {"name": "enterprise-risk", "summary": "Identifies, assesses, and tracks organizational risk — building and maintaining a risk register, scoring exposure, assigning owners and treatments, a…", "trigger": "Identifies, assesses, and tracks organizational risk — building and maintaining a risk register, scoring exposure, assigning owners and treatments, and preparing for audit. Use this to stand up a risk program, assess the risk in a decision or initiative, prepare for a certification or audit, decide whether a risk should be accepted, mitigated, transferred, or avoided, or report risk posture to leadership.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/legal-risk/skills/enterprise-risk/SKILL.md"}, {"name": "privacy-and-data-protection", "summary": "Assesses and improves how personal data is collected, used, shared, and retained — data mapping, lawful basis, consent, processor agreements, subject…", "trigger": "Assesses and improves how personal data is collected, used, shared, and retained — data mapping, lawful basis, consent, processor agreements, subject rights, and breach obligations. Use this before launching anything that handles personal data, when adding a vendor that will process it, when a data subject request arrives, when assessing exposure under GDPR or US state privacy laws, or when preparing for a privacy review.", "url": "https://github.com/cbrock84/headcount/blob/main/plugins/legal-risk/skills/privacy-and-data-protection/SKILL.md"}]}];
+
+const grid = document.getElementById('grid');
+const q = document.getElementById('q');
+const countEl = document.getElementById('count');
+const emptyEl = document.getElementById('empty');
+const revBtn = document.getElementById('revonly');
+const expandBtn = document.getElementById('expand');
+
+const totalSkills = DEPTS.reduce((n, d) => n + d.skills.length, 0);
+const reviewers = DEPTS.filter(d => d.reviewer);
+
+document.getElementById('figures').innerHTML = [
+ [DEPTS.length, 'departments'],
+ [totalSkills, 'skills'],
+ [reviewers.length, 'reviewer-class'],
+].map(([n, l]) => `<div class="figure"><b>${n}</b><span>${l}</span></div>`).join('');
+
+const esc = s => s.replace(/[&<>"]/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;'}[c]));
+
+function card(d) {
+ const el = document.createElement('section');
+ el.className = 'dept' + (d.reviewer ? ' rev' : '');
+ el.dataset.slug = d.slug;
+ el.innerHTML = `
+ <button class="head" aria-expanded="false">
+ <span style="flex:1">
+ <h2>${esc(d.title)}${d.reviewer ? ' <span class="revtag">reviewer</span>' : ''}</h2>
+ <span class="slug">${esc(d.slug)}</span>
+ </span>
+ <span class="role">${esc(d.exec)}</span>
+ <span class="n">${d.skills.length}</span>
+ </button>
+ <div class="body">
+ <div class="install">
+ <code>/plugin install ${esc(d.slug)}@headcount</code>
+ <button class="copy">Copy</button>
+ </div>
+ <ul>${d.skills.map(s => `
+ <li data-hay="${esc((s.name + ' ' + s.trigger).toLowerCase())}">
+ <a href="${s.url}" target="_blank" rel="noopener">
+ <span class="sname">${esc(d.slug)}:${esc(s.name)}</span>
+ <div class="sdesc">${esc(s.summary)}.</div>
+ </a>
+ </li>`).join('')}</ul>
+ </div>`;
+
+ const head = el.querySelector('.head');
+ head.addEventListener('click', () => {
+ const open = el.classList.toggle('open');
+ head.setAttribute('aria-expanded', String(open));
+ });
+
+ const copy = el.querySelector('.copy');
+ copy.addEventListener('click', async e => {
+ e.stopPropagation();
+ try {
+ await navigator.clipboard.writeText(`/plugin install ${d.slug}@headcount`);
+ copy.textContent = 'Copied';
+ setTimeout(() => { copy.textContent = 'Copy'; }, 1400);
+ } catch { copy.textContent = 'Select it'; }
+ });
+ return el;
+}
+
+const railCards = document.getElementById('rail-cards');
+DEPTS.forEach(d => (d.reviewer ? railCards : grid).appendChild(card(d)));
+
+function apply() {
+ const term = q.value.trim().toLowerCase();
+ const revOnly = revBtn.getAttribute('aria-pressed') === 'true';
+ let shown = 0, visibleDepts = 0;
+
+ document.querySelectorAll('.dept').forEach(el => {
+ const d = DEPTS.find(x => x.slug === el.dataset.slug);
+ if (revOnly && !d.reviewer) { el.classList.add('hidden'); return; }
+
+ let matches = 0;
+ el.querySelectorAll('li').forEach(li => {
+ const hit = !term || li.dataset.hay.includes(term);
+ li.classList.toggle('hidden', !hit);
+ if (hit) matches++;
+ });
+
+ const deptHit = !term
+ || d.title.toLowerCase().includes(term)
+ || d.slug.includes(term)
+ || d.exec.toLowerCase().includes(term);
+
+ if (matches === 0 && !deptHit) { el.classList.add('hidden'); return; }
+ if (deptHit && matches === 0) {
+ el.querySelectorAll('li').forEach(li => li.classList.remove('hidden'));
+ matches = d.skills.length;
+ }
+ el.classList.remove('hidden');
+ visibleDepts++;
+ shown += matches;
+ // A search is a request to see the hits, so open what matched.
+ if (term) {
+ el.classList.add('open');
+ el.querySelector('.head').setAttribute('aria-expanded', 'true');
+ }
+ });
+
+ // An empty dashed rail is a leftover, not a structure — hide it when neither reviewer matches.
+ const railVisible = [...railCards.querySelectorAll('.dept')]
+ .some(el => !el.classList.contains('hidden'));
+ document.getElementById('rail').style.display = railVisible ? '' : 'none';
+ document.querySelector('.stem').style.display = railVisible ? '' : 'none';
+
+ countEl.textContent = term || revOnly
+ ? `${shown} skill${shown === 1 ? '' : 's'} in ${visibleDepts} department${visibleDepts === 1 ? '' : 's'}`
+ : `${totalSkills} skills in ${DEPTS.length} departments`;
+ emptyEl.classList.toggle('on', visibleDepts === 0);
+}
+
+q.addEventListener('input', apply);
+revBtn.addEventListener('click', () => {
+ revBtn.setAttribute('aria-pressed', String(revBtn.getAttribute('aria-pressed') !== 'true'));
+ apply();
+});
+expandBtn.addEventListener('click', () => {
+ const anyClosed = [...document.querySelectorAll('.dept:not(.hidden)')]
+ .some(el => !el.classList.contains('open'));
+ document.querySelectorAll('.dept:not(.hidden)').forEach(el => {
+ el.classList.toggle('open', anyClosed);
+ el.querySelector('.head').setAttribute('aria-expanded', String(anyClosed));
+ });
+ expandBtn.textContent = anyClosed ? 'Collapse all' : 'Expand all';
+});
+apply();
+</script>
diff --git a/docs/org-chart.md b/docs/org-chart.md
index 0b09db9..9991f7d 100644
--- a/docs/org-chart.md
+++ b/docs/org-chart.md
@@ -1,23 +1,27 @@
# Org chart
```
- Chief Executive
- │
- ┌────────────┬────────────┬───────┴──────┬────────────┬────────────┐
- │ │ │ │ │ │
- CTO/CIO CPO CMO CRO CFO COO
-Technology Product Marketing + Revenue Finance Operations
- Demand Gen
- │ │ │ │ │ │
- CHRO CDO CCO CSO
- People Data & Analytics Customer Corporate
- Experience Strategy
- │ │ │ │ │ │
- └────────────┴──── Security (CISO) ─┬─ Legal & Risk (CLO/CCO) ─────┘
- │
- reviewer-class
+ Chief Executive
+ │
+ ┌──────────┬──────────┬──────────┬────┴─────┬──────────┬──────────┬──────────┐
+ CTO/CIO CPO CMO CRO CFO COO CDO CSO
+Technology Product Marketing + Revenue Finance Operations Data & Corporate
+ │ Demand Gen │ Analytics Strategy
+ CIO EPMO
+IT Operations Programme Management Office
+
+ CHRO CCO
+ People Customer Experience
+
+ ┌─────────────────────────────────────────────────────────────────────────┐
+ │ Security (CISO) Legal & Risk (CLO / CCO) │
+ │ reviewer-class │
+ └─────────────────────────────────────────────────────────────────────────┘
```
+An interactive version — searchable across every skill, linking out to each one — is generated at
+[`docs/org-chart.html`](org-chart.html).
+
Security and Legal & Risk sit across every function rather than under one. Both are reviewer-class:
they review what the other departments commit to, and their blocking findings are not overrulable by
the department under review. That is why the CISO and the CLO report to the chief executive rather
@@ -52,16 +56,23 @@ than into the function they oversee.
### Tier 1 — worth building next
-**Operations depth.** Three specialists. A business with physical production also needs
-`supply-chain-planning`, `quality-management`, and `capacity-planning`.
+**Legal depth.** Five skills. Missing `ip-and-licensing`, `regulatory-compliance`, and
+`audit-readiness` — the last pairing with `finance:internal-controls-and-audit`, which covers
+controls over financial reporting but not readiness for a wider audit.
-**Finance depth.** Four specialists covering planning and analysis. Missing `procurement`,
-`investment-analysis`, `cash-management`, `revenue-recognition`, and `financial-controls`.
+**Customer Experience depth.** Five skills, the thinnest department. Missing `customer-onboarding`,
+`churn-and-recovery`, and `community`.
-**People depth.** Missing `performance-management`, `employee-relations`,
-`learning-and-development`, and `workforce-planning`.
+**Corporate Strategy depth.** Five skills. Missing `competitive-intelligence` and
+`market-entry`.
-**Legal depth.** Missing `ip-and-licensing`, `regulatory-compliance`, and `audit-readiness`.
+**Built since this list was written**, and removed from it: operations gained supply chain, quality
+management and capacity planning; finance gained revenue recognition, cash management as
+`treasury-and-liquidity`, investment appraisal as `capital-allocation`, and financial controls as
+`internal-controls-and-audit`; people gained performance management, employee relations, learning
+and development, and workforce planning. `procurement` was judged already covered by
+`operations:vendor-management` and `it-operations:it-asset-management` rather than needing its own
+skill.
### Tier 2
diff --git a/scripts/build-org-chart.py b/scripts/build-org-chart.py
new file mode 100755
index 0000000..d8a5eca
--- /dev/null
+++ b/scripts/build-org-chart.py
@@ -0,0 +1,473 @@
+#!/usr/bin/env python3
+"""Generate the interactive org chart at docs/org-chart.html.
+
+Every department, skill, count and description comes from the tree, so the chart cannot claim an
+organization the repository does not have. `--check` compares the committed file against freshly
+generated output, the same contract as the README and the social card.
+
+ python3 scripts/build-org-chart.py regenerate
+ python3 scripts/build-org-chart.py --check fail if stale (CI)
+"""
+import glob
+import json
+import os
+import re
+import sys
+
+OUT = "docs/org-chart.html"
+REPO = "cbrock84/headcount"
+BLOB = f"https://github.com/{REPO}/blob/main"
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+# META and REVIEWER live in build-readme.py, which is not importable under that filename.
+# Read them out of it rather than keeping a second copy that can disagree.
+_src = open(os.path.join(os.path.dirname(os.path.abspath(__file__)), "build-readme.py"),
+ encoding="utf-8").read()
+META = eval(re.search(r"^META = (\{.*?^\})", _src, re.S | re.M).group(1))
+REVIEWER = eval(re.search(r"^REVIEWER = (\{.*?\})", _src, re.M).group(1))
+
+
+def first_sentence(desc, limit=150):
+ """The description's opening claim, before the 'Use this to ...' trigger list."""
+ cut = re.split(r"(?:\.\s+)(?:Also )?[Uu]se (?:this|it)\b", desc)[0].rstrip(" .,—-")
+ if len(cut) < 40:
+ cut = desc
+ return cut[: limit - 1].rstrip() + "…" if len(cut) > limit else cut
+
+
+def collect():
+ depts = []
+ for slug in sorted(
+ (os.path.basename(os.path.dirname(os.path.dirname(m)))
+ for m in glob.glob("plugins/*/.claude-plugin/plugin.json")),
+ key=lambda d: META[d][0],
+ ):
+ skills = []
+ for path in sorted(glob.glob(f"plugins/{slug}/skills/*/SKILL.md")):
+ text = open(path, encoding="utf-8").read()
+ front = re.match(r"^---\s*\n(.*?)\n---", text, re.S).group(1)
+ desc = re.search(r"^description:\s*(.*)$", front, re.M).group(1).strip()
+ name = os.path.basename(os.path.dirname(path))
+ skills.append({
+ "name": name,
+ "summary": first_sentence(desc),
+ "trigger": desc,
+ "url": f"{BLOB}/{path}",
+ })
+ _, title, exec_role = META[slug]
+ depts.append({
+ "slug": slug, "title": title, "exec": exec_role,
+ "reviewer": slug in REVIEWER, "skills": skills,
+ })
+ return depts
+
+
+TEMPLATE = r"""<meta charset="utf-8">
+<title>headcount org chart</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Archivo:wght@600;700&family=IBM+Plex+Mono:wght@400;500&family=IBM+Plex+Sans:wght@400;500;600&display=swap">
+<style>
+ /* Palette inherited from the repository's existing identity — the badge row and the social
+ preview card — rather than invented here. Light ground is a cool neutral: the accent is
+ already terracotta, and a warm cream under it is the stock look. */
+ :root {
+ --ground:#F6F7F9; --surface:#FFFFFF; --surface-2:#EEF1F4;
+ --line:#D8DEE6; --line-strong:#B9C3CE;
+ --ink:#141A21; --ink-2:#4A5866; --ink-3:#78889A;
+ --accent:#C2663F; --accent-ink:#FFFFFF; --accent-soft:rgba(194,102,63,.10);
+ --shadow:0 1px 2px rgba(20,26,33,.06), 0 8px 24px -12px rgba(20,26,33,.18);
+ --focus:#C2663F;
+ }
+ @media (prefers-color-scheme: dark) {
+ :root:not([data-theme="light"]) {
+ --ground:#0B0E14; --surface:#141A22; --surface-2:#1B222C;
+ --line:#252E3A; --line-strong:#3A4553;
+ --ink:#E6EDF3; --ink-2:#9FB0C3; --ink-3:#71818F;
+ --accent:#D97757; --accent-ink:#1A1006; --accent-soft:rgba(217,119,87,.13);
+ --shadow:0 1px 2px rgba(0,0,0,.4), 0 10px 30px -14px rgba(0,0,0,.7);
+ --focus:#D97757;
+ }
+ }
+ :root[data-theme="dark"] {
+ --ground:#0B0E14; --surface:#141A22; --surface-2:#1B222C;
+ --line:#252E3A; --line-strong:#3A4553;
+ --ink:#E6EDF3; --ink-2:#9FB0C3; --ink-3:#71818F;
+ --accent:#D97757; --accent-ink:#1A1006; --accent-soft:rgba(217,119,87,.13);
+ --shadow:0 1px 2px rgba(0,0,0,.4), 0 10px 30px -14px rgba(0,0,0,.7);
+ --focus:#D97757;
+ }
+
+ * { box-sizing:border-box; }
+ body {
+ margin:0; background:var(--ground); color:var(--ink);
+ font-family:"IBM Plex Sans","Helvetica Neue",Arial,sans-serif;
+ font-size:15px; line-height:1.5;
+ -webkit-font-smoothing:antialiased;
+ }
+ .wrap { max-width:1180px; margin:0 auto; padding:52px 28px 80px; }
+
+ /* ---- masthead ---- */
+ .eyebrow {
+ font-family:"IBM Plex Mono",monospace; font-size:12px; letter-spacing:.16em;
+ text-transform:uppercase; color:var(--ink-3);
+ }
+ h1 {
+ font-family:Archivo,"Helvetica Neue",sans-serif; font-weight:700;
+ font-size:clamp(34px,5vw,50px); letter-spacing:-.03em; line-height:1.05;
+ margin:12px 0 0; text-wrap:balance;
+ }
+ .lede { color:var(--ink-2); margin:12px 0 0; max-width:60ch; }
+ .figures { display:flex; flex-wrap:wrap; gap:26px; margin-top:26px; }
+ .figure b {
+ display:block; font-family:Archivo,sans-serif; font-weight:700;
+ font-size:27px; letter-spacing:-.02em; font-variant-numeric:tabular-nums;
+ }
+ .figure span {
+ font-family:"IBM Plex Mono",monospace; font-size:11px; letter-spacing:.13em;
+ text-transform:uppercase; color:var(--ink-3);
+ }
+
+ /* ---- controls ---- */
+ .controls {
+ display:flex; flex-wrap:wrap; gap:10px; align-items:center;
+ margin:34px 0 8px; position:sticky; top:0; z-index:5;
+ background:var(--ground); padding:12px 0; border-bottom:1px solid var(--line);
+ }
+ #q {
+ flex:1 1 260px; min-width:0; padding:10px 13px;
+ background:var(--surface); color:var(--ink);
+ border:1px solid var(--line-strong); border-radius:8px;
+ font-family:"IBM Plex Sans",sans-serif; font-size:14px;
+ }
+ #q::placeholder { color:var(--ink-3); }
+ .btn {
+ padding:10px 14px; background:var(--surface); color:var(--ink-2);
+ border:1px solid var(--line-strong); border-radius:8px; cursor:pointer;
+ font-family:"IBM Plex Sans",sans-serif; font-size:13px; font-weight:500;
+ }
+ .btn:hover { color:var(--ink); border-color:var(--ink-3); }
+ .btn[aria-pressed="true"] {
+ background:var(--accent-soft); border-color:var(--accent); color:var(--accent);
+ }
+ #count {
+ font-family:"IBM Plex Mono",monospace; font-size:12px; color:var(--ink-3);
+ font-variant-numeric:tabular-nums; white-space:nowrap;
+ }
+ :focus-visible { outline:2px solid var(--focus); outline-offset:2px; }
+
+ /* ---- chief executive + reviewer rail ---- */
+ .top { margin:38px 0 0; display:flex; flex-direction:column; align-items:center; }
+ .ceo {
+ background:var(--accent); color:var(--accent-ink);
+ border-radius:11px; padding:13px 26px; text-align:center; box-shadow:var(--shadow);
+ }
+ .ceo b {
+ font-family:Archivo,sans-serif; font-weight:700; font-size:17px; letter-spacing:-.01em;
+ display:block;
+ }
+ .ceo span { font-family:"IBM Plex Mono",monospace; font-size:11px; opacity:.8; }
+ .stem { width:2px; height:26px; background:var(--line-strong); }
+
+ .rail {
+ width:100%; border:1px dashed var(--accent); border-radius:12px;
+ background:var(--accent-soft); padding:16px 18px;
+ display:flex; flex-direction:column; gap:14px;
+ }
+ .rail-label {
+ font-family:"IBM Plex Mono",monospace; font-size:11px; letter-spacing:.13em;
+ text-transform:uppercase; color:var(--accent); text-align:center;
+ }
+ .rail-note {
+ text-align:center; color:var(--ink-2); font-size:13px;
+ max-width:66ch; margin:0 auto;
+ }
+ .rail-cards {
+ display:grid; gap:14px; grid-template-columns:repeat(auto-fit,minmax(260px,1fr));
+ }
+
+ /* ---- department grid ---- */
+ .grid {
+ margin-top:26px; display:grid; gap:14px;
+ grid-template-columns:repeat(auto-fill,minmax(290px,1fr));
+ }
+ .dept {
+ background:var(--surface); border:1px solid var(--line); border-radius:12px;
+ overflow:hidden; transition:border-color .12s ease;
+ }
+ .dept:hover { border-color:var(--line-strong); }
+ .dept.rev { border-color:var(--accent); }
+ .dept.open { border-color:var(--ink-3); box-shadow:var(--shadow); }
+ .dept.hidden { display:none; }
+
+ .head {
+ width:100%; text-align:left; background:none; border:0; cursor:pointer;
+ padding:15px 16px; display:flex; gap:12px; align-items:baseline; color:inherit;
+ font-family:inherit;
+ }
+ .head h2 {
+ margin:0; font-family:Archivo,sans-serif; font-weight:600; font-size:16px;
+ letter-spacing:-.012em; flex:1;
+ }
+ .role {
+ font-family:"IBM Plex Mono",monospace; font-size:11px; color:var(--ink-3);
+ white-space:nowrap;
+ }
+ .n {
+ font-family:"IBM Plex Mono",monospace; font-size:12px; color:var(--ink-2);
+ font-variant-numeric:tabular-nums;
+ }
+ .slug {
+ display:block; font-family:"IBM Plex Mono",monospace; font-size:11px;
+ color:var(--ink-3); margin-top:3px; font-weight:400;
+ }
+ .revtag {
+ font-family:"IBM Plex Mono",monospace; font-size:10px; letter-spacing:.1em;
+ text-transform:uppercase; color:var(--accent);
+ border:1px solid var(--accent); border-radius:4px; padding:1px 5px;
+ }
+
+ .body { display:none; border-top:1px solid var(--line); }
+ .dept.open .body { display:block; }
+ .install {
+ display:flex; gap:8px; align-items:center; padding:11px 16px;
+ background:var(--surface-2); border-bottom:1px solid var(--line);
+ }
+ .install code {
+ font-family:"IBM Plex Mono",monospace; font-size:12px; color:var(--ink-2);
+ overflow-x:auto; white-space:nowrap; flex:1; min-width:0;
+ }
+ .copy {
+ border:1px solid var(--line-strong); background:var(--surface); color:var(--ink-2);
+ border-radius:6px; padding:4px 9px; font-size:11px; cursor:pointer;
+ font-family:"IBM Plex Mono",monospace; white-space:nowrap;
+ }
+ .copy:hover { color:var(--ink); }
+
+ ul { list-style:none; margin:0; padding:0; }
+ li { border-bottom:1px solid var(--line); }
+ li:last-child { border-bottom:0; }
+ li.hidden { display:none; }
+ li a {
+ display:block; padding:12px 16px; text-decoration:none; color:inherit;
+ }
+ li a:hover { background:var(--surface-2); }
+ .sname {
+ font-family:"IBM Plex Mono",monospace; font-size:13px; font-weight:500;
+ color:var(--accent);
+ }
+ .sdesc { color:var(--ink-2); font-size:13.5px; margin-top:3px; }
+
+ .empty {
+ display:none; text-align:center; padding:56px 20px; color:var(--ink-3);
+ }
+ .empty.on { display:block; }
+ footer {
+ margin-top:52px; padding-top:20px; border-top:1px solid var(--line);
+ color:var(--ink-3); font-size:13px;
+ display:flex; flex-wrap:wrap; gap:10px; justify-content:space-between;
+ }
+ footer a { color:var(--ink-2); }
+ mark { background:var(--accent-soft); color:inherit; border-radius:2px; }
+ @media (prefers-reduced-motion:reduce) { * { transition:none !important; } }
+</style>
+
+<div class="wrap">
+ <div class="eyebrow">cbrock84 / headcount</div>
+ <h1>The org chart</h1>
+ <p class="lede">
+ An agent organization for Claude Code, structured as a company. Every department installs
+ independently. Search across every skill, or open a department to see what it holds.
+ </p>
+ <div class="figures" id="figures"></div>
+
+ <div class="controls">
+ <input id="q" type="search" placeholder="Search 135 skills — try “threat”, “pricing”, “backup”…" autocomplete="off">
+ <button class="btn" id="revonly" aria-pressed="false">Reviewer-class only</button>
+ <button class="btn" id="expand">Expand all</button>
+ <span id="count"></span>
+ </div>
+
+ <div class="top">
+ <div class="ceo"><b>Chief Executive</b><span>executive</span></div>
+ <div class="stem"></div>
+ <div class="rail" id="rail">
+ <div class="rail-label">Reviewer-class — reports to the chief executive</div>
+ <p class="rail-note">
+ Security and Legal&nbsp;&amp; Risk review what the other departments commit to, and their
+ blocking findings are not overrulable by the department under review. That is why they report
+ to the chief executive rather than into the function they oversee.
+ </p>
+ <div class="rail-cards" id="rail-cards"></div>
+ </div>
+ </div>
+
+ <div class="grid" id="grid"></div>
+ <div class="empty" id="empty">No skill or department matches that.</div>
+
+ <footer>
+ <span>Generated from the repository tree — <code>scripts/build-org-chart.py</code></span>
+ <span><a href="https://github.com/cbrock84/headcount">github.com/cbrock84/headcount</a> · MIT</span>
+ </footer>
+</div>
+
+<script>
+const DEPTS = __DATA__;
+
+const grid = document.getElementById('grid');
+const q = document.getElementById('q');
+const countEl = document.getElementById('count');
+const emptyEl = document.getElementById('empty');
+const revBtn = document.getElementById('revonly');
+const expandBtn = document.getElementById('expand');
+
+const totalSkills = DEPTS.reduce((n, d) => n + d.skills.length, 0);
+const reviewers = DEPTS.filter(d => d.reviewer);
+
+document.getElementById('figures').innerHTML = [
+ [DEPTS.length, 'departments'],
+ [totalSkills, 'skills'],
+ [reviewers.length, 'reviewer-class'],
+].map(([n, l]) => `<div class="figure"><b>${n}</b><span>${l}</span></div>`).join('');
+
+const esc = s => s.replace(/[&<>"]/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;'}[c]));
+
+function card(d) {
+ const el = document.createElement('section');
+ el.className = 'dept' + (d.reviewer ? ' rev' : '');
+ el.dataset.slug = d.slug;
+ el.innerHTML = `
+ <button class="head" aria-expanded="false">
+ <span style="flex:1">
+ <h2>${esc(d.title)}${d.reviewer ? ' <span class="revtag">reviewer</span>' : ''}</h2>
+ <span class="slug">${esc(d.slug)}</span>
+ </span>
+ <span class="role">${esc(d.exec)}</span>
+ <span class="n">${d.skills.length}</span>
+ </button>
+ <div class="body">
+ <div class="install">
+ <code>/plugin install ${esc(d.slug)}@headcount</code>
+ <button class="copy">Copy</button>
+ </div>
+ <ul>${d.skills.map(s => `
+ <li data-hay="${esc((s.name + ' ' + s.trigger).toLowerCase())}">
+ <a href="${s.url}" target="_blank" rel="noopener">
+ <span class="sname">${esc(d.slug)}:${esc(s.name)}</span>
+ <div class="sdesc">${esc(s.summary)}.</div>
+ </a>
+ </li>`).join('')}</ul>
+ </div>`;
+
+ const head = el.querySelector('.head');
+ head.addEventListener('click', () => {
+ const open = el.classList.toggle('open');
+ head.setAttribute('aria-expanded', String(open));
+ });
+
+ const copy = el.querySelector('.copy');
+ copy.addEventListener('click', async e => {
+ e.stopPropagation();
+ try {
+ await navigator.clipboard.writeText(`/plugin install ${d.slug}@headcount`);
+ copy.textContent = 'Copied';
+ setTimeout(() => { copy.textContent = 'Copy'; }, 1400);
+ } catch { copy.textContent = 'Select it'; }
+ });
+ return el;
+}
+
+const railCards = document.getElementById('rail-cards');
+DEPTS.forEach(d => (d.reviewer ? railCards : grid).appendChild(card(d)));
+
+function apply() {
+ const term = q.value.trim().toLowerCase();
+ const revOnly = revBtn.getAttribute('aria-pressed') === 'true';
+ let shown = 0, visibleDepts = 0;
+
+ document.querySelectorAll('.dept').forEach(el => {
+ const d = DEPTS.find(x => x.slug === el.dataset.slug);
+ if (revOnly && !d.reviewer) { el.classList.add('hidden'); return; }
+
+ let matches = 0;
+ el.querySelectorAll('li').forEach(li => {
+ const hit = !term || li.dataset.hay.includes(term);
+ li.classList.toggle('hidden', !hit);
+ if (hit) matches++;
+ });
+
+ const deptHit = !term
+ || d.title.toLowerCase().includes(term)
+ || d.slug.includes(term)
+ || d.exec.toLowerCase().includes(term);
+
+ if (matches === 0 && !deptHit) { el.classList.add('hidden'); return; }
+ if (deptHit && matches === 0) {
+ el.querySelectorAll('li').forEach(li => li.classList.remove('hidden'));
+ matches = d.skills.length;
+ }
+ el.classList.remove('hidden');
+ visibleDepts++;
+ shown += matches;
+ // A search is a request to see the hits, so open what matched.
+ if (term) {
+ el.classList.add('open');
+ el.querySelector('.head').setAttribute('aria-expanded', 'true');
+ }
+ });
+
+ // An empty dashed rail is a leftover, not a structure — hide it when neither reviewer matches.
+ const railVisible = [...railCards.querySelectorAll('.dept')]
+ .some(el => !el.classList.contains('hidden'));
+ document.getElementById('rail').style.display = railVisible ? '' : 'none';
+ document.querySelector('.stem').style.display = railVisible ? '' : 'none';
+
+ countEl.textContent = term || revOnly
+ ? `${shown} skill${shown === 1 ? '' : 's'} in ${visibleDepts} department${visibleDepts === 1 ? '' : 's'}`
+ : `${totalSkills} skills in ${DEPTS.length} departments`;
+ emptyEl.classList.toggle('on', visibleDepts === 0);
+}
+
+q.addEventListener('input', apply);
+revBtn.addEventListener('click', () => {
+ revBtn.setAttribute('aria-pressed', String(revBtn.getAttribute('aria-pressed') !== 'true'));
+ apply();
+});
+expandBtn.addEventListener('click', () => {
+ const anyClosed = [...document.querySelectorAll('.dept:not(.hidden)')]
+ .some(el => !el.classList.contains('open'));
+ document.querySelectorAll('.dept:not(.hidden)').forEach(el => {
+ el.classList.toggle('open', anyClosed);
+ el.querySelector('.head').setAttribute('aria-expanded', String(anyClosed));
+ });
+ expandBtn.textContent = anyClosed ? 'Collapse all' : 'Expand all';
+});
+apply();
+</script>
+"""
+
+
+def render():
+ depts = collect()
+ total = sum(len(d["skills"]) for d in depts)
+ html = TEMPLATE.replace("__DATA__", json.dumps(depts, ensure_ascii=False))
+ return html.replace("Search 135 skills", f"Search {total} skills"), len(depts), total
+
+
+def main():
+ html, ndept, nskill = render()
+ if "--check" in sys.argv:
+ current = open(OUT, encoding="utf-8").read() if os.path.exists(OUT) else ""
+ if current != html:
+ print(f" {OUT} is stale — run: python3 scripts/build-org-chart.py")
+ return 1
+ print("org chart is current")
+ return 0
+ os.makedirs(os.path.dirname(OUT), exist_ok=True)
+ open(OUT, "w", encoding="utf-8").write(html)
+ print(f"{OUT} regenerated — {ndept} departments, {nskill} skills")
+ return 0
+
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/scripts/build-readme.py b/scripts/build-readme.py
index 0d62894..278d202 100755
--- a/scripts/build-readme.py
+++ b/scripts/build-readme.py
@@ -147,6 +147,7 @@ out += [
"docs/AGENT-SURFACES.md every path has exactly one owner, enforced in CI",
"docs/DECISION-LOG.md numbered decisions with options and recommendations",
"docs/USE-CASES.md situations worked end to end across departments",
+ "docs/org-chart.html interactive org chart, searchable across every skill",
"```",
"",
"Agents split by **exclusive write surface**, not by topic — a topic split has no checkable",
diff --git a/scripts/check-all.sh b/scripts/check-all.sh
index e7e5674..ab5684b 100755
--- a/scripts/check-all.sh
+++ b/scripts/check-all.sh
@@ -27,6 +27,8 @@ run "README is current" \
python3 scripts/build-readme.py --check
run "Social card is current" \
python3 scripts/build-social-card.py --check
+run "Org chart is current" \
+ python3 scripts/build-org-chart.py --check
run "Skill references resolve" \
python3 scripts/check-skill-refs.py
run "Manifests parse" \