# Human Management

Use when admin requests adding a human user to the system, changing human permissions...

- Repository: https://github.com/agentscope-ai/AgentTeams (5913 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add agentscope-ai/AgentTeams --skill human-management -g -a claude-code -y`
Codex: `npx skills add agentscope-ai/AgentTeams --skill human-management -g -a codex -y`
Cursor: `npx skills add agentscope-ai/AgentTeams --skill human-management -g -a cursor -y`
Gemini CLI: `npx skills add agentscope-ai/AgentTeams --skill human-management -g -a gemini-cli -y`

## Description

Use when admin requests adding a human user to the system, changing human permissions, removing human access, or managing human accounts.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Human Management

Import real human accounts into AgentTeams with configurable permission levels. Humans use their own Matrix client (Element) to communicate with agents.

## Permission Levels (inclusive, higher includes all lower)

| Level | Can talk to | Use case |
|-------|------------|----------|
| 1 | Manager + all Team Leaders + all Workers (= Admin equivalent) | CTO, tech lead |
| 2 | Specified Team Leaders + their Workers + specified standalone Workers | Team member, PM |
| 3 | Specified Workers only | External collaborator |

## Quick Create

```bash
bash /opt/agentteams/agent/skills/human-management/scripts/create-human.sh \
  --matrix-id "@john:domain" --name "John Doe" \
  --level 2 --teams alpha-team --workers standalone-dev \
  --email john@example.com
```

> Full workflow: read `references/create-human.md`

## Gotchas

- **Humans don't need containers, MinIO, or Higress**, they only need Matrix room access and groupAllowFrom entries
- **Email is optional but recommended**, if provided, a welcome email with credentials is sent automatically
- **Matrix account is registered automatically**, username from `--matrix-id`, random password generated
- **Level 1 humans get access to everything**, `--teams` and `--workers` are ignored
- **Level 3 humans ignore `--teams`**, only `--workers` matters
- **Changing permission level requires recalculating all groupAllowFrom**, use `create-human.sh` with `--update` flag

## Operation Reference

| Admin wants to... | Read | Key script |
|---|---|---|
| Add a human user | `references/create-human.md` | `scripts/create-human.sh` |
| List/query humans |, | `agt get humans` |
| Remove human access |, | `agt delete human <name>` |