How do I install the Team skill?

Run npx skillmds@latest add cluesmith/team in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Team?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

cluesmith (@cluesmith) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Team by cluesmith — Agent Skill

Name: Team
Author: cluesmith

Team

Team CLI — manage team members, post messages, and run activity updates. ALWAYS check this skill before running any `team` command. Use when listing members, adding members, posting messages, or running team activity updates. Note - `afx team` is deprecated; use `team` directly.

cluesmith 704dde9 3.2 KB Updated Sep 17, 2026

File contents

team - Team Coordination CLI

Manage team members and messages for your Codev project. Team data is stored in codev/team/ and displayed in the Tower dashboard.

Synopsis

team list
team message <text> [-a <author>]
team update
team add <github-handle> [-n <name>] [-r <role>]

Commands

team list

List all team members from codev/team/people/.

team list

Displays a formatted table with Name, GitHub handle, and Role columns.

team message <text>

Post a message to the team message log (codev/team/messages.md).

team message "Spec 42 is ready for review"
team message "Deployed to staging" -a deploy-bot

Options:

-a, --author <name> — Override author (default: auto-detected from gh CLI or git config)

team update

Post an hourly activity summary. Called automatically by cron (.af-cron/team-update.yaml) or manually.

team update

Collects notable events from the last hour (builder spawns, gate approvals, PR merges, completed reviews) and posts a summary. Exits silently if no events occurred.

team add <github-handle>

Scaffold a new team member file.

team add waleedkadous
team add jdoe --name "Jane Doe" --role "Developer"

Options:

-n, --name <name> — Full name (default: github handle)
-r, --role <role> — Role (default: "Team Member")

Creates codev/team/people/<handle>.md with YAML frontmatter. Handle is normalized to lowercase. Fails if the member already exists.

Team Directory Structure

codev/team/
├── people/
│   ├── waleedkadous.md     # YAML frontmatter + optional bio
│   └── jdoe.md
└── messages.md             # Append-only message log

Team Member File Format

---
name: M Waleed Kadous
github: waleedkadous
role: Lead Architect
---

Optional freeform bio or notes (not displayed in Tower).

Required frontmatter fields:

name — Display name
github — GitHub handle (used for API data enrichment)
role — Team role (displayed in Tower)

Message Log Format

# Team Messages

<!-- Append new messages below. Do not edit or delete existing entries. -->

---
**waleedkadous** | 2026-03-09 14:30 UTC
Spec 42 is ready for review.

---
**tower-cron** | 2026-03-09 15:00 UTC
Hourly update: Merged PR #123: Add user auth. Gate approved for #42.

Messages are append-only. Each entry has an author, UTC timestamp, and body text.

Deprecation Note

afx team commands still work but print a deprecation warning. Use team directly:

afx team list → team list
afx team message → team message
afx team update → team update

Setup

To set up a team directory for a new project:

team add first-member --name "First Member" --role "Architect"
team add second-member --name "Second Member" --role "Developer"

The Team tab appears in Tower when 2+ valid members exist.

---name: teamdescription: Team CLI — manage team members, post messages, and run activity updates. ALWAYS check this skill before running any `team` command. Use when listing members, adding members, posting messages, or running team activity updates. Note - `afx team` is deprecated; use `team` directly.---# team - Team Coordination CLIManage team members and messages for your Codev project. Team data is stored in `codev/team/` and displayed in the Tower dashboard.## Synopsis```team listteam message <text> [-a <author>]team updateteam add <github-handle> [-n <name>] [-r <role>]```## Commands### team listList all team members from `codev/team/people/`.```bashteam list```Displays a formatted table with Name, GitHub handle, and Role columns.### team message \<text\>Post a message to the team message log (`codev/team/messages.md`).```bashteam message "Spec 42 is ready for review"team message "Deployed to staging" -a deploy-bot```**Options:**- `-a, --author <name>` — Override author (default: auto-detected from `gh` CLI or `git config`)### team updatePost an hourly activity summary. Called automatically by cron (`.af-cron/team-update.yaml`) or manually.```bashteam update```Collects notable events from the last hour (builder spawns, gate approvals, PR merges, completed reviews) and posts a summary. Exits silently if no events occurred.### team add \<github-handle\>Scaffold a new team member file.```bashteam add waleedkadousteam add jdoe --name "Jane Doe" --role "Developer"```**Options:**- `-n, --name <name>` — Full name (default: github handle)- `-r, --role <role>` — Role (default: "Team Member")Creates `codev/team/people/<handle>.md` with YAML frontmatter. Handle is normalized to lowercase. Fails if the member already exists.## Team Directory Structure```codev/team/├── people/│ ├── waleedkadous.md # YAML frontmatter + optional bio│ └── jdoe.md└── messages.md # Append-only message log```## Team Member File Format```yaml---name: M Waleed Kadousgithub: waleedkadousrole: Lead Architect---Optional freeform bio or notes (not displayed in Tower).```**Required frontmatter fields:**- `name` — Display name- `github` — GitHub handle (used for API data enrichment)- `role` — Team role (displayed in Tower)## Message Log Format```markdown# Team Messages---**waleedkadous** | 2026-03-09 14:30 UTCSpec 42 is ready for review.---**tower-cron** | 2026-03-09 15:00 UTCHourly update: Merged PR #123: Add user auth. Gate approved for #42.```Messages are append-only. Each entry has an author, UTC timestamp, and body text.## Deprecation Note`afx team` commands still work but print a deprecation warning. Use `team` directly:- `afx team list` → `team list`- `afx team message` → `team message`- `afx team update` → `team update`## SetupTo set up a team directory for a new project:```bashteam add first-member --name "First Member" --role "Architect"team add second-member --name "Second Member" --role "Developer"```The Team tab appears in Tower when 2+ valid members exist.

Frequently asked questions