describe-colleague

Synthesize Slack and GitHub activity into a structured colleague profile.

5|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/tomzx/agents --skill describe-colleague
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: describe-colleague
Source: https://github.com/tomzx/agents/tree/main/skills/describe-colleague
Command: npx skills add https://github.com/tomzx/agents --skill describe-colleague

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate a structured profile of a colleague by synthesizing their Slack and GitHub activity into a concise overview of strengths, weaknesses, interests, and avoidances.

Core Features & Use Cases

  • Synthesize strengths, weaknesses, interests, and avoidances from Slack messages and GitHub contributions.
  • Produce a readable colleague profile to inform onboarding, pairing decisions, and performance discussions.
  • Use Case: For a new hire, generate a profile to guide 1:1s and collaboration norms.

Quick Start

DescribeColleague <colleague> to generate and save the profile to your notes directory under colleagues/<colleague>.md.

Frequently Asked Questions about describe-colleague

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a teammate profile from Slack and GitHub activity?

Generate a teammate profile by synthesizing Slack messages and public GitHub contributions into a structured overview of strengths, weaknesses, and interests. The profile is saved as a markdown file in your configured notes directory.

What do I need to set up to analyze a colleague's work style from chat and code?

Analyzing a colleague's work style requires access to a Slack MCP server, an authenticated GitHub CLI, and a configured NOTES_DIR. These dependencies allow the tool to fetch activity and persist the generated profile.

Can I use this to create an onboarding profile for a new hire?

Yes, you can create an onboarding profile for a new hire to guide 1:1s and establish collaboration norms. It synthesizes their public Slack and GitHub contributions into a concise summary of their professional strengths and avoidances.

How do I save a generated colleague profile to my notes?

The generated colleague profile is saved directly to your notes directory under colleagues/<colleague>.md. You must have the NOTES_DIR environment variable configured for the output file to persist correctly.

What is the best way to summarize a teammate's strengths and weaknesses for a performance discussion?

Summarizing a teammate's strengths and weaknesses is best done by synthesizing their GitHub contributions and Slack messages into a structured profile. This provides a readable, data-backed overview for performance discussions and pairing decisions.