docs: update skills for team CRUD commands

- flashduty-admin: document team get/create/update/delete commands,
  all flags, team lifecycle workflow, and member replacement warning
- flashduty-shared: add team get to reference lookups, add safety
  rules for team delete and member list replacement

Author: debidong

skills/flashduty-admin/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: flashduty-admin
 version: 1.0.0
-description: "Flashduty administration: list teams and members, search audit logs for compliance and investigation. Commands: team list, member list, audit search. Use when looking up person IDs or team IDs for other commands, finding contact information, searching who performed specific actions, or reviewing audit trails for compliance."
+description: "Flashduty administration: manage teams (list, get, create, update, delete), list members, and search audit logs for compliance and investigation. Commands: team list/get/create/update/delete, member list, audit search. Use when managing team structure, looking up person IDs or team IDs for other commands, finding contact information, searching who performed specific actions, or reviewing audit trails for compliance."
 metadata:
   requires:
     bins: ["flashduty"]
@@ -28,11 +28,82 @@ flashduty team list [flags]
 
 | Flag | Type | Default | Description |
 |------|------|---------|-------------|
-| `--name` | string | | Search by team name |
+| `--name` | string | | Search by team name substring |
 | `--page` | int | 1 | Page number |
+| `--limit` | int | 20 | Page size, max 100 |
+| `--orderby` | string | | Sort field: `created_at`, `updated_at`, `team_name` |
+| `--asc` | bool | false | Sort in ascending order |
+| `--person-id` | int | 0 | Filter teams by member ID |
 
 Output columns: ID, NAME, MEMBERS.
 
+### team get
+
+Get detailed information about a specific team. Specify the team by exactly one of `--id`, `--name`, or `--ref-id`.
+
+```bash
+flashduty team get --id <team_id>
+flashduty team get --name "SRE Team"
+flashduty team get --ref-id "hr-dept-42"
+```
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--id` | int | Team ID |
+| `--name` | string | Team name (exact match) |
+| `--ref-id` | string | External reference ID |
+
+Output fields: ID, Name, Description, Status, Ref ID, Members, Created, Updated, Created By, Updated By.
+
+### team create
+
+Create a new team. The `--name` flag is required and must be unique (1-39 characters).
+
+```bash
+flashduty team create --name "SRE Team" [flags]
+```
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--name` | string | **Required.** Team name (1-39 characters) |
+| `--description` | string | Team description (max 500 characters) |
+| `--person-ids` | string | Comma-separated member person IDs |
+| `--emails` | string | Comma-separated email addresses to invite |
+| `--ref-id` | string | External reference ID for HR system integration |
+
+### team update
+
+Update an existing team. The `--id` flag is required. **WARNING:** `--person-ids` replaces the entire member list. Use `team get` to see current members before updating.
+
+```bash
+flashduty team update --id <team_id> [flags]
+```
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--id` | int | **Required.** Team ID |
+| `--name` | string | New team name (1-39 characters) |
+| `--description` | string | New description (max 500 characters) |
+| `--person-ids` | string | Comma-separated member person IDs (replaces entire member list) |
+| `--emails` | string | Comma-separated email addresses to invite |
+| `--ref-id` | string | External reference ID |
+
+### team delete
+
+Permanently delete a team. Specify the team by exactly one of `--id`, `--name`, or `--ref-id`. This action is **irreversible**. You will be prompted for confirmation unless `--force` is set.
+
+```bash
+flashduty team delete --id <team_id>
+flashduty team delete --name "Old Team" --force
+```
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--id` | int | Team ID |
+| `--name` | string | Team name |
+| `--ref-id` | string | External reference ID |
+| `--force` | bool | Skip confirmation prompt |
+
 ### member list
 
 List organization members with contact details and status.
@@ -107,14 +178,44 @@ flashduty team list
 
 # Search for a specific team by name
 flashduty team list --name "Platform"
+
+# Get full detail for a specific team
+flashduty team get --id 123
+
+# Look up a team by external reference ID
+flashduty team get --ref-id "hr-dept-42"
+```
+
+### Team Lifecycle Management
+
+```bash
+# Create a new team with initial members
+flashduty team create --name "SRE Team" --description "Site Reliability" --person-ids 1,2,3
+
+# Create a team and invite members by email
+flashduty team create --name "Backend Team" --emails alice@example.com,bob@example.com
+
+# Rename a team
+flashduty team update --id 123 --name "Platform SRE"
+
+# Replace the entire member list (check current members first!)
+flashduty team get --id 123
+flashduty team update --id 123 --person-ids 1,2,3,4,5
+
+# Delete a team (prompts for confirmation)
+flashduty team delete --id 123
+
+# Delete without confirmation (for scripting)
+flashduty team delete --id 123 --force
 ```
 
 ## Key Concepts
 
 - **Member IDs** (int64) are used across many commands: incident assign/reassign, audit filters, oncall schedules.
 - **Team IDs** (int64) are used for filtering: oncall schedules, postmortem list, channels.
+- **Team update replaces members** -- `--person-ids` is a full replacement, not an append. Always check current members with `team get` before updating.
+- **Team delete is irreversible** -- requires confirmation in interactive mode; requires `--force` in non-interactive (CI/scripted) mode.
 - **Audit logs** track all mutations in the system -- useful for compliance, incident investigation, and change tracking.
-- All admin commands in the CLI are **read-only**.
 
 ## Cross-References
 

skills/flashduty-shared/SKILL.md

@@ -179,6 +179,9 @@ flashduty member list --email "john@example.com"
 # Find a team ID
 flashduty team list --name "SRE"
 
+# Get full team detail by ID, name, or ref-id
+flashduty team get --id 123
+
 # Find a channel (collaboration space) ID
 flashduty channel list --name "Production"
 
@@ -202,10 +205,12 @@ flashduty status-page list
 2. **NEVER** merge incidents or alerts without user confirmation -- merges are **irreversible**.
 3. **NEVER** snooze incidents unless the user specifies a duration.
 4. **NEVER** reassign or reopen incidents without user confirmation.
-5. **Always** show what will be affected before executing destructive or mutating operations.
-6. When in doubt about severity or scope, **list first, then act**.
-7. Prefer **read-only** operations (`list`, `get`, `detail`) unless the user explicitly requests a mutation.
-8. For bulk operations (multiple IDs), enumerate the targets and confirm before proceeding.
+5. **NEVER** delete a team without explicit user confirmation -- deletion is **irreversible**.
+6. **NEVER** update a team's member list without showing the current members first -- `--person-ids` replaces the entire list.
+7. **Always** show what will be affected before executing destructive or mutating operations.
+8. When in doubt about severity or scope, **list first, then act**.
+9. Prefer **read-only** operations (`list`, `get`, `detail`) unless the user explicitly requests a mutation.
+10. For bulk operations (multiple IDs), enumerate the targets and confirm before proceeding.
 
 ---