version: "1.0.1" name: describe-colleague description: Generate a profile for a colleague based on their Slack and GitHub activity, covering strengths, weaknesses, interests, avoids, and other relevant information. argument-hint: "[colleague]"

BASE_DIR=!~/.agents/scripts/get-env NOTES_DIR

Describe Colleague

Generates a structured profile for a colleague by synthesizing their Slack and GitHub activity, capturing strengths, weaknesses, interests, and avoidances.

Prerequisites

• Slack MCP server connected and authenticated
• gh CLI authenticated
• NOTES_DIR environment variable set (resolved via ~/.agents/scripts/get-env NOTES_DIR)
• Colleague identifier ({COLLEAGUE}) provided as argument or from context

Steps

1. Retrieve NOTES_DIR from environment:

`` ~/.agents/scripts/get-env NOTES_DIR ``

1. Search GitHub for the colleague's contributions using gh:

`` gh search commits --author={COLLEAGUE} --limit 50 gh search prs --author={COLLEAGUE} --limit 50 ``

1. Review their Slack messages and threads via the Slack MCP server.

Do not read local files.

1. Synthesize observations into the profile format below.
2. Write the profile to {BASE_DIR}/colleagues/{COLLEAGUE}.md.

Output Format

# Strengths
 
-<strength>
 
# Weaknesses
 
-<weakness>
 
# Interests
 
-<topic>
 
# Avoids
 
-<topic>
 
# Other relevant information
 
-<item>

Example Usage

Scenario 1: Profile a specific colleague

/describe-colleague alice

Searches GitHub for alice's commits and PRs, reviews her Slack messages, then writes a profile to {NOTES_DIR}/colleagues/alice.md.

Scenario 2: Update an existing profile

/describe-colleague bob

If {NOTES_DIR}/colleagues/bob.md already exists, overwrite it with a refreshed profile incorporating recent activity.

Scenario 3: Colleague with limited GitHub activity

/describe-colleague carol

Carol's contributions are primarily via Slack. Profile is weighted toward Slack observations, with a note that GitHub data is sparse.

Useful Commands Reference