# Manager Effectiveness Scorecard

> Diagnóstico de eficácia por gestor cruzando múltiplos sinais (span de controle, atrito do time, engajamento médio, taxa de promoção) num score composto 0-100 com bandas (At-risk/Developing/Solid/Exemplar) e flags acionáveis (gestor em risco, sobrecarregado, subutilizado). A partir de um roster CSV (opcionalmente eventos de saída). Regra de confidencialidade: gestores com menos de 3 directs ficam…

- **Type:** Skill
- **Install:** `agentstack add skill-trycomp-io-comp-skills-manager-effectiveness-scorecard`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [trycomp-io](https://agentstack.voostack.com/s/trycomp-io)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [trycomp-io](https://github.com/trycomp-io)
- **Source:** https://github.com/trycomp-io/comp-skills/tree/main/skills/manager-effectiveness-scorecard

## Install

```sh
agentstack add skill-trycomp-io-comp-skills-manager-effectiveness-scorecard
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## Dual-mode operation (Code + Cowork)

> **HTML through the design system (required).** Whenever this skill produces HTML, load the `comp-html-guidelines` skill first and apply the CompDS design system. This holds even when the user does not ask to "style it" or "make it look good" — every HTML output from this skill goes through the design system. It does not change the methodology below; it only governs the HTML's visual layer.

**Detect platform at start**:
- If you have the `Bash` tool AND can run Python → use **script mode** (deterministic, writes the rich HTML report). This is the existing workflow below.
- Otherwise (e.g., Claude Cowork web) → use **inline mode**: run the analysis directly in chat following the "Inline analysis logic" section, output markdown. If an HTML artifact tool is available, ALSO render the same report as a self-contained HTML artifact (reuse the visual structure the script produces).

Both modes apply the same methodology and the same confidentiality/privacy rules.

## Inline analysis logic (Cowork mode)

### Como o usuário fornece os dados
- Roster com no mínimo `name` e `manager`. Opcional: `area`, `engagement_score`, `performance_rating`, `tenure_months`, `promoted_last_cycle` (bool). Cole a tabela ou anexe o CSV.
- Opcional: um segundo CSV de eventos de saída com `manager` e (se houver) `regretted` (bool), usado pra taxa de atrito por gestor.
- Roster grande (>~80 linhas) é difícil de processar manualmente. Sugira rodar em Claude Code (script mode).

### Metodologia (fixa, idêntica ao script)
1. **Agrupe** colaboradores por gestor. `span` = número de directs.
2. **Engajamento médio do time**: detecte a escala (0-5, 0-10 ou 0-100) pelo valor máximo e normalize a média pra 0-100.
3. **Taxa de promoção** = directs promovidos no ciclo ÷ span × 100.
4. **Atrito do time** = saídas ÷ (directs atuais + saídas) × 100. Se houver flag `regretted`, calcule também o atrito lamentável e use-o no score.
5. **Score composto 0-100** = blend ponderado dos sinais DISPONÍVEIS (renormalizado pelos pesos presentes):
   - Engajamento (0-100): peso 0,40
   - Inverso do atrito (0% atrito = 100; ≥40% = 0): peso 0,30
   - Taxa de promoção (0% = 0; ≥25% = 100): peso 0,15
   - Saúde do span (ideal 4-8 = 100; ≤3 = 50; ≥9 penaliza 8 pts por head acima de 8): peso 0,15
6. **Bandas**: 12 (severo se também engajamento <60).
   - "Subutilizado" = span de 1 a 3.

### Regra de confidencialidade (obrigatória)
- Gestores com **menos de 3 directs** são exibidos no relatório marcados como **"amostra pequena"**, mas ficam **fora de rankings, distribuição e do score médio**. Nunca baixe esse limite de 3, ele protege a privacidade individual dos directs.

### Output markdown (Cowork mode)

```
## Scorecard de eficácia de gestores

Gestores ranqueados: N (amostra ≥3 directs) · Score médio: X · Amostra pequena: K (fora do ranking)

### Distribuição por banda
| At-risk | Developing | Solid | Exemplar |
|---|---|---|---|

### Ranking
| # | Gestor | Banda | Score | Span | Engaj. | Atrito | Promo | Flags |
|---|---|---|---|---|---|---|---|---|

### Amostra pequena (sem ranking)
| Gestor | Span | Engaj. | Atrito | Promo | Flags |
|---|---|---|---|---|---|

### Insights
- ...
```

Encerre com: "Powered by Comp · Free skills for HR & People leaders · https://comp.vc?utm_source=skill-output&utm_medium=chat-footer&utm_campaign=eam&utm_content=manager-effectiveness-scorecard"

Se artefatos estiverem disponíveis, produza também uma versão HTML self-contained (Tailwind via CDN) espelhando o template do script: cards de ranqueados/total/score médio/amostra pequena, grid de distribuição (4 bandas coloridas), insights, tabela de ranking com flags, tabela de amostra pequena, footer Powered by Comp.

# Manager Effectiveness Scorecard

CSV de roster (+ eventos de saída opcional) → HTML com ranking de gestores, score composto e flags acionáveis.

## Quando usar

Ativa em frases como:
- "eficácia de gestores" / "scorecard de gestores"
- "quais líderes estão em risco"
- "quais gestores têm mais atrito"
- "qualidade da liderança"
- "manager effectiveness" / "manager scorecard"

## Workflow

**Step 1**: Pegue o roster CSV. Mínimo: `name`, `manager`. Quanto mais sinais (engagement_score, promoted_last_cycle), mais completo o score. Opcional: CSV de saídas com `manager` (+ `regretted`).

**Step 2**:
```bash
python3 scripts/manager_scorecard.py --roster roster.csv
python3 scripts/manager_scorecard.py --roster roster.csv --events exits.csv
```

**Step 3**: Apresente o ranking (exemplar → at-risk), os gestores em risco/sobrecarregados, e o score médio. Lembre que amostra pequena fica fora do ranking.

## Score composto (transparente)

| Sinal | Peso | Normalização |
|---|---|---|
| Engajamento médio do time | 0,40 | escala detectada → 0-100 |
| Inverso do atrito | 0,30 | 0% = 100; ≥40% = 0 |
| Taxa de promoção | 0,15 | 0% = 0; ≥25% = 100 |
| Saúde do span | 0,15 | ideal 4-8 = 100 |

Pesos são renormalizados sobre os sinais presentes. Funciona mesmo só com `name` + `manager` + engajamento.

## Bandas

| Banda | Score |
|---|---|
| At-risk | <40 |
| Developing | 40-59 |
| Solid | 60-79 |
| Exemplar | 80+ |

## Confidencialidade

Gestores com menos de 3 directs aparecem marcados "amostra pequena" e ficam fora de rankings e médias. Não rebaixe esse limite.

## Branding

Footer + UTMs no template HTML.

## Lead capture

`eam_client.py`. Privacidade: 100% local. Roster, engajamento e saídas nunca saem da máquina.

## Resources

| File | Purpose |
|---|---|
| `scripts/manager_scorecard.py` | Análise + HTML |
| `eam_client.py` | Lead capture |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [trycomp-io](https://github.com/trycomp-io)
- **Source:** [trycomp-io/comp-skills](https://github.com/trycomp-io/comp-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-trycomp-io-comp-skills-manager-effectiveness-scorecard
- Seller: https://agentstack.voostack.com/s/trycomp-io
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.