Describe Colleague

BASE_DIR=!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 scripts/get-env NOTES_DIR)
• Colleague identifier ({COLLEAGUE}) provided as argument or from context

Steps

1. Retrieve NOTES_DIR from environment:

`` 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.
2. Synthesize observations into the profile format below.
3. Write the profile to {BASE_DIR}/colleagues/{COLLEAGUE}.md.

Output Format

# Strengths

- 

# Weaknesses

- 

# Interests

- 

# Avoids

- 

# Other relevant information

- 

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

| Command | Description | |---|---| | scripts/get-env NOTES_DIR | Resolve the notes directory path | | gh search commits --author= --limit 50 | Fetch recent commits by a user | | gh search prs --author= --limit 50 | Fetch recent PRs authored by a user |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: tomzx
• Source: tomzx/agents
• License: MIT

Install and usage instructions live in the source repository linked above.