team-overview

Shows registered BotMinter teams, their members, roles, workspaces, and running state. Use when the operator asks to "show teams", "list teams", "who is on the team", "team status", "show members", or "what teams do I have". Reads ~/.botminter/config.yml and workspace directories.

8 stars

bybotminter

View on GitHub Installation ↓

Best use case

team-overview is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Teams using team-overview should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/team-overview/SKILL.md --create-dirs "https://raw.githubusercontent.com/botminter/botminter/main/minty/.claude/skills/team-overview/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/team-overview/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How team-overview Compares

Feature / Agent	team-overview	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Team Overview

Shows registered BotMinter teams with their members, roles, workspaces, and running state.

## Data Sources

| Source | Path | Contains |
|--------|------|----------|
| Team registry | `~/.botminter/config.yml` | Team names, paths, profiles, GitHub repos, credentials |
| Team repo | `<team-path>/team/` | Member configs, knowledge, invariants |
| Member config | `<team-path>/team/members/<member>/` | ralph.yml, PROMPT.md, CLAUDE.md |
| Workspace | `<team-path>/<member>/` | Workspace repo with `.botminter.workspace` marker |

## How to List Teams

Read the team registry:

```bash
cat ~/.botminter/config.yml
```

Parse the YAML to extract team entries. Each team has:
- `name` — team identifier
- `path` — local filesystem path to the team directory
- `profile` — which profile the team uses (e.g., `scrum`, `scrum-compact`)
- `github_repo` — the GitHub repo URL for coordination
- `credentials.gh_token` — GitHub token (do NOT display this)

### No Teams Configured

If `~/.botminter/config.yml` does not exist or has no teams, tell the operator:

> No teams registered yet. To create a team, run `bm init`.

## How to List Members

For each team, read the members directory:

```bash
ls <team-path>/team/members/
```

Each subdirectory is a member. To get member details, read their config:

```bash
cat <team-path>/team/members/<member>/ralph.yml
```

This shows their hat collection (roles they can perform) and Ralph Orchestrator configuration.

## How to Check Running State

Check if members have active Ralph processes by looking for lock files:

```bash
cat <team-path>/<member>/.ralph/loop.lock 2>/dev/null
```

If the lock file exists and contains a PID, the member is running. If it does not exist, the member is stopped.

Alternatively, use the CLI:

```bash
bm status -t <team-name>
```

## How to Check Workspace State

Verify a member's workspace is provisioned:

```bash
test -f <team-path>/<member>/.botminter.workspace && echo "provisioned" || echo "not provisioned"
```

If not provisioned, suggest:

```bash
bm teams sync -t <team-name>
```

## Output Format

Present the overview as a structured summary:

```
## Teams

### <team-name>
- **Profile:** <profile>
- **GitHub:** <github-repo>
- **Path:** <team-path>

| Member | Role | Workspace | Running |
|--------|------|-----------|---------|
| alice  | architect | provisioned | stopped |
| bob    | developer | provisioned | running |

---
```

## CLI Quick Reference

| Task | Command |
|------|---------|
| List teams | `bm teams list` |
| Show team details | `bm teams show <name>` |
| List members | `bm members list -t <team>` |
| Show member details | `bm members show <member> -t <team>` |
| Check status | `bm status -t <team>` |
| Sync workspaces | `bm teams sync -t <team>` |

Related Skills

team-design

from botminter/botminter

Entry point for all day-2 team design operations. Routes operator intent to the appropriate sub-skill — retrospective, role-management, member-tuning, or process-evolution — and provides a unified dashboard of team design state. Use when asked to "design the team", "show me the team", "team overview", "what's our team setup", "let's evolve the team", "team health check", or when the operator's intent spans multiple team design areas.

workspace-sync

from botminter/botminter

Sync and diagnose BotMinter workspaces. Use when the operator says "sync workspaces", "apply profile changes", "propagate changes", "update all workspaces", "check workspace health", "diff against profile", "full sync", "my workspace has old files", or "why is the workspace out of date". Do NOT use for member behavior/config tuning (use member-tuning) or structured process changes (use process-evolution).

role-management

from botminter/botminter

Manages team role composition — list, add, remove, and inspect roles defined in botminter.yml. Includes impact analysis of statuses, hats, and knowledge before changes, and records every change as a team agreement decision. Use when asked to "add a role", "remove a role", "list roles", "inspect a role", "change team composition", "what roles do we have", "team structure", or when an cos:exec:todo issue requests a role change.

retrospective

from botminter/botminter

Guides a structured team retrospective examining what went well, what didn't, and produces typed action items. Outputs a retro summary to agreements/retros/. Use when asked to "run a retro", "do a retrospective", "reflect on the sprint", "what went well", "review team performance", or when an cos:exec:todo issue requests a retrospective.

process-evolution

from botminter/botminter

Guides deliberate, team-wide process changes — adding or removing statuses, modifying transitions, updating review gates, and evolving the workflow lifecycle. Validates changes against the status graph before applying and records every decision as a team agreement. Use when asked to "change the process", "add a status", "remove a status", "modify the workflow", "update transitions", "add a review gate", "evolve the process", "change auto-advance rules", or when an cos:exec:todo issue requests a process change.

member-tuning

from botminter/botminter

Diagnoses and tunes individual member configurations by mapping symptoms to the responsible artifact — PROMPT.md, CLAUDE.md, ralph.yml (hats), skills, or PROCESS.md. Provides a diagnostic decision tree, inspection commands, example edits, and propagation steps for each artifact type. Use when asked to "tune a member", "fix a member", "troubleshoot a member", "member isn't working", "adjust member behavior", "member diagnostic", "why is the member doing X", or when an cos:exec:todo issue requests member tuning.

cos-session

from botminter/botminter

Chief of Staff working session with the operator. Use when the operator says "chief of staff session", "cos session", "I have things to file", "let's work through some items", "I found some problems", "what's <member> doing", "let's go over the board", or brings any mix of observations, bugs, ideas, or operational concerns.

github-project

from botminter/botminter

Manages GitHub Projects v2 workflows for issue tracking and project management. Use when user asks to "show the board", "view issues", "what's in [status]", "create an epic", "add a story", "create a bug", "move issue

workspace-doctor

from botminter/botminter

Diagnoses common BotMinter workspace issues — stale submodules, broken symlinks, missing files, outdated context, and sync problems. Use when the operator asks to "check my workspace", "diagnose issues", "why isn't X working", "fix my setup", "workspace health", or "something seems wrong".

profile-design

from botminter/botminter

Designs and troubleshoots BotMinter profiles — team methodology templates that define roles, statuses, hats, skills, and process conventions. Use when the operator asks to "design a profile", "create a new role", "fork a profile", "fix my profile", "troubleshoot profile issues", "design a process workflow", "add a hat", "customize a profile", or "validate my profile". Operates on profile templates, not live team repos.

profile-browser

from botminter/botminter

Browses and describes BotMinter profiles — team methodology templates that define roles, statuses, coding agents, and process conventions. Use when the operator asks to "list profiles", "show profiles", "what profiles are available", "describe a profile", "what roles does X have", or "compare profiles". Reads ~/.config/botminter/profiles/.

hire-guide

from botminter/botminter

Interactive guide for hiring team members with `bm hire`. Helps operators choose roles, pick names, and understand hiring implications. Use when the operator asks to "hire someone", "add a member", "what roles can I hire", "help me hire", "who should I hire next", or "explain the roles".