Helps engineering managers identify, quantify, and reduce hidden capacity drains that make teams miss commitments even when everyone is busy.

MITAuto-check passedDevOps & Cloud

Install Shadow Work

skills CLI
$ npx skills add manager-dot-dev/manager-skills --skill shadow-work -a claude-code

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

GitHub CLI
$ gh skill install manager-dot-dev/manager-skills shadow-work --agent claude-code

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

Manual copy
$ git clone --depth 1 https://github.com/manager-dot-dev/manager-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/shadow-work .claude/skills/shadow-work && rm -rf skills-src

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

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

Facts

Skill name
shadow-work
GitHub stars
114
Token cost
~2.3k tokens
SKILL.md length
1,244 words
Files
2 (incl. references)
Skills in repo
27
Repo updated
First seen
Licence
MIT

At a glance

Helps engineering managers identify, quantify, and reduce hidden capacity drains that make teams miss commitments even when everyone is busy.

  • Works in 5 steps: Likely shadow-work type - name the… → What to measure for 2-6 weeks -… → Immediate containment - what to do this… → …
  • The user mentions invisible work
  • SKILL.md covers Before Starting, Response Style, How to Use This Skill and Default Response Shape, plus 9 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Shadow Work is an agent skill from manager-dot-dev/manager-skills. Helps engineering managers identify, quantify, and reduce hidden capacity drains that make teams miss commitments even when everyone is busy. Use this skill whenever the user mentions invisible work, untracked work, support requests consuming the team, glue work, shadow backlog, sprint spillover, capacity planning being wrong, teams always underestimating, senior engineers burning out, or "we are busy but nothing ships." Produces a diagnostic, evidence plan, and concrete interventions.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/sources.md`).

It sits in DevOps & Cloud, covering Site reliability engineering. The repository describes itself as: Skills for engineering managers. The licence is MIT.

When your agent uses it

  • The user mentions invisible work
  • Support requests consuming the team
  • Sprint spillover
  • Capacity planning being wrong

Example prompts

  • “we are busy but nothing ships.”
  • “Use the shadow-work skill to help engineering managers identify, quantify, and reduce hidden capacity drains that make teams miss commitments even…”
  • “/shadow-work”

Workflow steps

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

  1. Likely shadow-work type - name the type(s), with confidence and evidence from the user's prompt.
  2. What to measure for 2-6 weeks - lightweight signals, not a heavy process rollout.
  3. Immediate containment - what to do this week so the team stops bleeding capacity.
  4. Structural fix - what to change in planning, ownership, rotation, recognition, or PM/EM workflow.
  5. Stakeholder message - a concise script the EM can use with PMs, leadership, or the team.

What it can do on your machine

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

  • Tool permissions

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

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

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

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Shadow Work loads about 2.3k tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 126 tokens; SKILL.md has 1,244 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~126
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.4k

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

Safety

Auto-check passed

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

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

SKILL.md

The full file from manager-dot-dev/manager-skills at commit c47ebc7, republished under its MIT licence (© manager-dot-dev). 1,244 words, ~2,263 tokens.

Download SKILL.mdSave it as .claude/skills/shadow-work/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
shadow-work
description
Helps engineering managers identify, quantify, and reduce hidden capacity drains that make teams miss commitments even when everyone is busy. Use this skill whenever the user mentions invisible work, untracked work, support requests consuming the team, glue work, shadow backlog, sprint spillover, capacity planning being wrong, teams always underestimating, senior engineers burning out, or "we are busy but nothing ships." Produces a diagnostic, evidence plan, and concrete interventions.
metadata.version
2.1.2

Shadow Work

Before Starting

Check for EM context first. If .agents/em-context.md exists, read it.

If .agents/em-context.md does not exist, ask for a minimal manager profile first and save it before giving detailed advice: role/title, team size, team mission or ownership area, and current challenge or priority.

If a specific person is central to the conversation and .agents/reports/[name].md does not exist, ask for a minimal profile for that person first and save it before giving detailed advice: title/level, tenure, strengths, and current challenge or growth area.

If the conversation reveals durable new context later, update .agents/em-context.md or .agents/reports/[name].md automatically. Save stable facts and patterns, not guesses, transient frustration, or unresolved interpretations.

Response Style

Keep the first answer concise and useful. Do not dump the whole framework unless the user asks for depth.

Default to:

  • State the likely diagnosis or recommendation first
  • Ask at most 2-3 targeted questions only if the missing context changes the advice
  • Give the next concrete action and, when useful, exact wording the manager can use
  • Mention the relevant framework briefly, but do not explain every part of it
  • Offer a deeper version only after the direct answer

How to Use This Skill

  • Team misses commitments but everyone seems busy -> diagnose all three shadow-work types and identify the dominant capacity drain
  • Ad-hoc incidents and support requests eat capacity -> start with Type 1: Invisible Production Support
  • Senior engineers burn out doing unglamorous coordination -> start with Type 2: Glue Work
  • Off-the-record requests quietly consume sprints -> start with Type 3: The Shadow Backlog
  • Remote team has weak visibility into what people actually absorb -> include The Remote Amplification Problem

Default Response Shape

When the user asks for help, do not only explain the concept. Produce a practical diagnosis:

  1. Likely shadow-work type - name the type(s), with confidence and evidence from the user's prompt.
  2. What to measure for 2-6 weeks - lightweight signals, not a heavy process rollout.
  3. Immediate containment - what to do this week so the team stops bleeding capacity.
  4. Structural fix - what to change in planning, ownership, rotation, recognition, or PM/EM workflow.
  5. Stakeholder message - a concise script the EM can use with PMs, leadership, or the team.

If the user's facts are thin, ask for the minimum missing data: where the work comes from, who absorbs it, how often it happens, and whether it is currently tracked anywhere.


What Shadow Work Is

Shadow work is untracked work that consumes real capacity but does not appear in the plan. It makes teams consistently miss commitments without anyone understanding why. It falls into three types, and each type requires a different response.

The key management move is not "work harder" or "estimate better." The first move is to make the work legible enough that the team can make tradeoffs honestly.


Diagnostic Questions

Use these questions before prescribing fixes:

  • Source: Where does the unplanned work come from: production, other teams, PM requests, managers, engineers, customers, or the codebase itself?
  • Absorber: Who usually handles it? Is it evenly distributed, or does it concentrate on one or two senior people?
  • Visibility: Does it appear in tickets, sprint boards, incident logs, review docs, or performance reviews?
  • Pattern: Is it recurring, seasonal, project-specific, or random?
  • Cost: Does it mostly cost calendar time, focus time, emotional energy, roadmap capacity, or promotion credit?
  • Tradeoff: What planned work silently loses when this work appears?

Type 1: Invisible Production Support

Ad-hoc incident triage, alert investigation, support-team requests, manual fixes, and customer escalations that never enter the ticket system.

Without tracking, patterns go unnoticed. The same 15-minute manual fix can burn hundreds of hours annually while the root cause stays unfixed. The team appears to have capacity but consistently underdelivers, and has no data to show why.

What to do:

  • Create a lightweight category for unplanned support work, even if it is only a tag in the ticketing system
  • Track for 4-6 weeks, then run a frequency analysis: top recurring issues, top request sources, top absorbers
  • Rotate hot-fix responsibility instead of letting one person become the permanent human circuit breaker
  • Convert repeated manual fixes into roadmap items with a visible cost-of-delay argument

Type 2: Glue Work

Code reviews, mentoring, onboarding, documentation, coordination, cross-team translation, and "can you just help them unblock?" work that lands disproportionately on senior engineers.

Glue work creates two problems when unmanaged: the engineers doing it burn out without recognition, and the engineers not doing it get promoted without learning the work that keeps the organization functioning.

What to do:

  • Name glue work explicitly in performance conversations and promotion packets
  • Distribute the skills downward through pairing, live review sessions, office hours, and rotating ownership
  • Protect senior engineers' maker time when they are acting as multipliers
  • Track whether glue work is becoming a default identity for one person rather than a shared team capability

Show full SKILL.md (448 more words)Show less

Type 3: The Shadow Backlog

Work outside the official roadmap: PMs making off-the-record fix requests, engineers taking longer routes they know are right, unplanned integrations negotiated directly with other teams, and "small asks" that never look small in aggregate.

This can quietly consume a large share of real capacity while breaking trust between business and engineering. Leadership sees a team that commits and misses, without seeing where the capacity went.

What to do:

  • In planning, ask: "What are we likely to get asked to do that we have not scoped?"
  • Budget explicit shadow capacity when the environment is noisy; start with 10-20% if you lack data
  • Redirect off-the-record PM requests into the official backlog without shaming the requester
  • Periodically present shadow backlog data to stakeholders as evidence for roadmap tradeoffs

The Remote Amplification Problem

For remote teams, shadow work is doubly invisible: your manager cannot casually observe it either. This means you have no natural evidence when advocating for a team member's raise or promotion, and weak visibility when capacity is being consumed.

Building lightweight tracking habits is therefore management infrastructure, not overhead. It protects the team's ability to get credit for real work and gives the EM evidence for capacity conversations.


Stakeholder Scripts

Use direct, non-accusatory language. The goal is to expose the tradeoff, not blame the source of the work.

With a PM: "I want to make these requests visible because they are real work. If we keep handling them outside the backlog, we will keep missing the planned roadmap and neither of us will have good data. Let's add them to the board and decide what they displace."

With leadership: "The team is not missing commitments because the estimates are careless. We are absorbing unplanned work that is not represented in the plan. I am going to track it for the next few weeks and come back with the recurring sources, cost, and options."

With a senior engineer doing too much glue work: "I see how much coordination and review work you are absorbing. Some of it is valuable, but I do not want it to become invisible or trap you away from growth work. Let's decide what should be recognized, rotated, or stopped."


Dive Deeper

If the user asks where a framework came from, wants to read the original article, or wants more context on any topic in this skill, read references/sources.md.


  • roadmap-planning - Shadow work should be explicitly budgeted in capacity planning, not ignored
  • working-with-pm - Off-the-record requests are a PM-EM relationship problem, not just a capacity problem
  • retaining-developers - Senior engineers absorbing invisible glue work without recognition are in the "unappreciated" retention state
  • knowledge-sharing - Glue work often overlaps with documentation and onboarding failures

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

Files

SKILL.md and 1 other file (references) in skills/shadow-work of manager-dot-dev/manager-skills.

  • SKILL.md
  • references/sources.md

Open the folder on GitHubat commit c47ebc7

Compare with similar skills

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

Shadow Work compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shadow Work this skillmanager-dot-dev/manager-skills114—~2.3kAutomated safety check: PassMIT
Inference Autopilotrednote-machine-learning/Inference-autopilot142—~4.5kAutomated safety check: PassApache-2.0
Executing Distributed System Testsshenli/distributed-system-testing231—~5.1kAutomated safety check: NotesMIT
Alerting Irmgrafana/skills2781 repos~1.9kAutomated safety check: PassApache-2.0
Agentforce D360 Analyzeforcedotcom/sf-skills1.1k—~2.9kAutomated safety check: PassApache-2.0
Promqlgrafana/skills2781 repos~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Inference Autopilot

    rednote-machine-learning/Inference-autopilot

    Analyze, benchmark, diagnose, and optimize large-model inference deployments from hardware inventory, model details, workload traces, and latency or throughput SLOs.

    142 GitHub stars~4.5k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Executing Distributed System Tests

    shenli/distributed-system-testing

    A skill your agent uses when running a previously designed distributed-systems test plan against a real or simulated cluster — driving fault injection, workload, chaos scenarios, linearizability /…

    231 GitHub stars~5.1k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check: notes
  • Alerting Irm

    grafana/skills

    Official

    Configure Grafana Alerting, Incident Response Management (IRM), and SLOs end-to-end — provisions Grafana-managed and data-source-managed alert rules, contact points (Slack/PagerDuty/email/webhook)…

    278 GitHub starsUsed in 1 repo~1.9k tokens
    DevOps & CloudAuto-check passed
  • Agentforce D360 Analyze

    forcedotcom/sf-skills

    Data Cloud 360° view of a single Agentforce session. An agent skill from forcedotcom/sf-skills.

    1.1k GitHub stars~2.9k tokensUpdated 4 days ago
    DevOps & CloudAuto-check passed
  • Promql

    grafana/skills

    Official

    Write, validate, and optimize PromQL for Prometheus / Grafana Mimir / Grafana Cloud Metrics.

    278 GitHub starsUsed in 1 repo~1.1k tokens
    DevOps & CloudAuto-check passed
  • Slo Implementation

    wshobson/agents

    Define and implement Service Level Indicators (SLIs) and Service Level Objectives (SLOs) with error budgets and alerting.

    40k GitHub starsUsed in 10 repos~1.7k tokens
    DevOps & CloudAuto-check passed

More from manager-dot-dev/manager-skills

All 27 skills in this repo
  • Em Grid Scorer

    manager-dot-dev/manager-skills

    Score an Engineering Manager's coverage across all 12 cells of the EM Grid based on their calendar and Slack.

    114 GitHub stars~5.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Em Context

    manager-dot-dev/manager-skills

    Foundation skill for engineering managers. An agent skill from manager-dot-dev/manager-skills.

    114 GitHub stars~1.6k tokensUpdated 5 mo ago
    Auto-check passed
  • 1on1s

    manager-dot-dev/manager-skills

    Prepares agendas, diagnoses struggling 1:1 relationships, and gives frameworks for running effective 1:1 meetings with direct reports.

    114 GitHub stars~3k tokensUpdated 5 mo ago
    Auto-check passed
  • Business Literacy

    manager-dot-dev/manager-skills

    Explains business financial terms and frameworks for engineering managers — produces term definitions (ARR, COGS, CAC, LTV, gross margin, burn rate, EBITDA, AARRR), translation formulas for making…

    114 GitHub stars~2.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Career Development

    manager-dot-dev/manager-skills

    Helps engineering managers support direct report growth — produces a stage-by-stage model of engineering impact (Circles of Influence), a framework for non-linear career planning (Tarzan Method)…

    114 GitHub stars~2.3k tokensUpdated 5 mo ago
    Auto-check passed
  • Delegation

    manager-dot-dev/manager-skills

    Guides managers out of the bottleneck role — provides the Team Rep pattern, Epic Ownership model, Task-Relevant Maturity framework, kingdom ownership, and three-layer assignment strategy.

    114 GitHub stars~3.3k tokensUpdated 5 mo ago
    Auto-check passed

Categories

Questions about Shadow Work

What does Shadow Work do?

Helps engineering managers identify, quantify, and reduce hidden capacity drains that make teams miss commitments even when everyone is busy. Shadow Work is an agent skill from manager-dot-dev/manager-skills. Helps engineering managers identify, quantify, and reduce hidden capacity drains that make teams miss commitments even when everyone is busy.

When should I use Shadow Work?

Shadow Work fits situations like: the user mentions invisible work; support requests consuming the team; sprint spillover; capacity planning being wrong.

How do I install Shadow Work in Claude Code?

Run `npx skills add manager-dot-dev/manager-skills --skill shadow-work -a claude-code`. Or copy the skill folder (skills/shadow-work in manager-dot-dev/manager-skills) into .claude/skills/shadow-work in your project. Claude Code loads it when a task matches its description.

How do I install Shadow Work in Codex?

Run `npx skills add manager-dot-dev/manager-skills --skill shadow-work -a codex`. Or copy the skill folder (skills/shadow-work in manager-dot-dev/manager-skills) into .agents/skills/shadow-work in your project. Codex loads it when a task matches its description.

Can I use Shadow Work in Cursor, Gemini CLI or GitHub Copilot?

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

What does Shadow Work need to run?

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

Does Shadow Work access the network?

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

Is Shadow Work safe to install?

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

What licence does Shadow Work use?

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

How many tokens does Shadow Work use?

About 2.3k tokens (SKILL.md is roughly 9.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 89 tokens, read only when the agent opens those files.

What are the alternatives to Shadow Work?

Skills that share tags, products or a category with Shadow Work: Inference Autopilot (rednote-machine-learning/Inference-autopilot, 142 stars), Executing Distributed System Tests (shenli/distributed-system-testing, 231 stars), Alerting Irm (grafana/skills, 278 stars) and Agentforce D360 Analyze (forcedotcom/sf-skills, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shadow Work?

manager-dot-dev (a GitHub organization) maintains it in manager-dot-dev/manager-skills, which has 114 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on May 9, 2026.

Source: manager-dot-dev/manager-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.