profile-explorer
Interactive profile exploration combining lookup, segments, and event history. Use when the user wants to explore a user profile, view segment memberships, or browse event history for an identity.
How do I install this agent skill?
npx skills add https://github.com/lytics/agent-skills --skill profile-explorerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill enables users to explore Lytics user profiles and segment memberships through the official Lytics API. It employs secure practices, such as using environment variables for authentication and standard tools like curl for data retrieval. No security risks or malicious patterns were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Profile Explorer
Purpose
Interactive profile exploration that combines identity lookup, segment membership analysis, and event history browsing. Provides a comprehensive view of an individual user profile.
Environment
Requires authenticated API access. See ../references/auth.md for credential resolution.
Inputs
- Identity field and value (e.g.,
email,user@example.com) - Or: exploration query (e.g., "find a user in the high-value segment")
Exploration Flow
Step 1: Look Up Profile
Use entity-lookup skill:
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/user/${FIELD}/${VALUE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
Step 2: Get Segment Memberships
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/api/entity/user/segments/${FIELD}/${VALUE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
Step 3: Present Profile Summary
Display a structured profile view:
## Profile: user@example.com
### Identity
- email: user@example.com
- user_id: 12345
- _uid: abc-def-ghi
### Key Attributes
- Name: Jane Smith
- Country: US
- City: Portland, OR
- Created: 2024-01-15
- Last Active: 2025-03-18
### Engagement
- Visit Count: 47
- Avg Visit Time: 3.2 min
- Content Affinity: Technology, Marketing
### Segment Memberships
- High Value Customers (segment)
- Email Subscribers (aspect)
- Q1 Campaign Target (list)
### Recent Events
[Summary from stream data if available]
Step 4: Interactive Exploration
After presenting the summary, the user can:
- "What segments is this user in?" -> Show detailed segment list
- "Show me their purchase history" -> Look up relevant fields
- "Compare with another user" -> Look up second profile
- "Why are they in segment X?" -> Cross-reference segment FilterQL with profile data
Finding Users
If the user doesn't have a specific identity:
- Ask what they're looking for
- Suggest searching by segment: list segment members using segment scan
- Help them identify the right profile
Error Handling
- Profile not found: Try alternative identity fields, suggest checking spelling
- Multiple identities: Show all linked identities, confirm which profile
- Large profile: Summarize key fields, offer to show full details on request
Dependencies
- Composes:
entity-lookup skill,segment-manager skill,stream-inspector skill - References:
../references/auth.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/lytics/agent-skills/profile-explorer">View profile-explorer on skillZs</a>