people-lookup
People Lookup via Glean
When users ask about people in the organization, use Glean's employee search and activity signals to find the right person.
Tool Naming
See the glean-tools-guide skill for Glean MCP tool naming conventions. Tools follow the pattern mcp__glean_[server-name]__[tool] where the server name is dynamic. Use whatever Glean server is available in your tool list.
When This Applies
Use this approach when users ask:
- "Who works on [system/project]?"
- "Who is [name]?" or "What team is [name] on?"
- "Who should I talk to about [topic]?"
- "Who owns [component/service]?"
- "Who reports to [manager]?"
- "Find someone who knows about [technology]"
BE SKEPTICAL
Not everyone who appears in search results is a good recommendation.
Expertise Evidence Test
- Is there real evidence of expertise?
- ✅ STRONG: Multiple signals (code + docs + involvement)
- ⚠️ MODERATE: Single signal but significant
- ❌ WEAK: Just mentioned once, attended a meeting
Recency Test
- Are they actively involved?
- ✅ ACTIVE: Activity in past 6 months
- ⚠️ HISTORICAL: 6-12 months ago
- ❌ STALE: 12+ months - likely outdated
Availability Test
- Are they still in a relevant position?
- ✅ CURRENT: Same team/role
- ⚠️ MOVED: Changed teams but retains knowledge
- ❌ GONE: Left company or completely different role
Filter Out:
- Single mentions without other evidence
- People who just attended meetings on a topic
- Former employees
- People whose involvement is tangential
Quality over quantity: Better to recommend 2 right people than 10 weak matches.
Tool Selection
| User Intent | Glean Tool |
|---|---|
| Find by name, role, team | employee_search |
| Find by code contributions | code_search |
| Find by document authorship | search with owner: filter |
| Complex expertise analysis | chat |
Critical: Use employee_search for People Queries
Never use regular search for people lookups. The employee_search tool is specifically designed for:
- Name lookups
- Role/title searches
- Team/department queries
- Org chart navigation
- Reporting relationships
Query Examples
# Find by name
employee_search "John Smith"
# Find by team
employee_search "payments team"
# Find direct reports
employee_search "reportsto:\"Jane Doe\""
# Find by role type
employee_search "engineering managers"
# Find recent hires
employee_search "startafter:2024-01-01"
Finding Expertise (Not Just Role)
For "who actually knows about X" questions, combine signals:
- Official role:
employee_search "[topic]" - Code activity:
code_search "[topic] owner:\"name\"" - Doc authorship:
search "[topic] RFC owner:\"name\""
People with multiple signals are true experts. Single-signal matches should be noted with lower confidence.
If No Good Matches Found
Don't pad with weak recommendations:
No strong expertise matches found for [topic].
**What was checked:**
- Employee search: [results]
- Code contributions: [results]
- Doc authorship: [results]
**Suggestions:**
- Ask in [relevant channel]
- Check with [related team] leadership
Relationship to Commands
For comprehensive expertise discovery, suggest:
/glean-people:find-expert <topic>- Multi-signal expertise analysis/glean-people:stakeholders <change>- Find who needs to be involved/glean-docs:onboarding <team>- Get to know a new team
More from gleanwork/claude-plugins
code-exploration
Use when the user asks about internal code, implementations, patterns across repositories, or needs to understand how something is built. Triggers on "how is X implemented", "where is the code for", "find the implementation of", "what repos contain", "who wrote the code for", or code architecture questions about internal systems.
15glean-tools-guide
Use when Glean MCP tools are available and you need guidance on which tool to use, how to format queries, or best practices for enterprise search. This skill provides tool selection logic and query optimization for Glean integrations. Auto-triggers when mcp__glean tools are being considered.
14activity-synthesis
Use when the user asks about their recent work, what they've been doing, their contributions, or needs to recall past activity. Triggers on phrases like "what have I been working on", "what did I do last week", "my recent activity", "what have I accomplished", "summarize my work", "what projects am I on", or when the user needs to recall or reflect on their own work.
13project-awareness
Use when the user asks about project status, ownership, or context. Triggers on phrases like "status of X project", "who owns Y", "what's happening with Z", "project update", "where does the project stand", "what's the state of", "who's working on", or when needing quick project context without a full analysis.
13enterprise-search
Use when the user asks about company documents, internal wikis, policies, specifications, design docs, RFCs, or enterprise knowledge. Triggers on phrases like "find the doc about", "what's our policy on", "where is the spec for", "company guidelines", "internal documentation", or when searching for information that would be in enterprise systems rather than the local codebase.
12skill-creation-guide
Auto-triggers when users discuss creating skills or ask about SKILL.md format. Triggers on phrases like "create a skill", "write a skill", "make a skill", "new skill", "SKILL.md format", "skill structure", "how do skills work", "skill best practices", or when the user wants to add custom behavior to Claude Code.
11