cluesmith/team
.claude/skills/team/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add cluesmith/codev teamInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 7:48 AM4.6s1 file scanned
SKILL.md
- name:
- team
- description:
- 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 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 fromghCLI orgit 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 namegithub— 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 listafx team message→team messageafx 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.
Related Skills
cluesmith/porch
tools
VerifiedTrustedCommunity
Protocol orchestrator CLI — drives SPIR, ASPIR, AIR, TICK, and BUGFIX protocols via a state machine. ALWAYS check this skill before running any `porch` command. Use when you need to check project status, approve gates, signal phase completion, or manage protocol state. Also use when a builder asks about gate approvals or phase transitions.
254SKILL.mdUpdated Apr 4, 2026
cluesmith/generate-image
development
VerifiedTrustedCommunity
AI image generation via Gemini. Use when the user wants to generate, create, or make an image, or when you need to create visual assets like logos, diagrams, or illustrations. Requires GEMINI_API_KEY or GOOGLE_API_KEY.
254SKILL.mdUpdated Apr 4, 2026
cluesmith/consult
tools
VerifiedTrustedCommunity
AI consultation CLI — query Gemini, Codex, or Claude for reviews and analysis. ALWAYS check this skill before running any `consult` command. Use when reviewing specs, plans, implementations, or PRs with external models, running parallel 3-way reviews (cmap), or checking consultation stats. The `-m` model flag is always required except for `consult stats`.
254SKILL.mdUpdated Apr 4, 2026
cluesmith/codev
tools
VerifiedTrustedCommunity
Codev project management CLI — init, adopt, update, and doctor commands. Check this skill before running any `codev` command (except `consult`, `porch`, or `afx` which have their own skills). Use when setting up new projects, adding codev to existing repos, updating framework files, or diagnosing missing dependencies.
254SKILL.mdUpdated Apr 4, 2026