profile-investigator

Diagnose user segment membership and trace data lineage with FilterQL.

4|1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/lytics/agent-skills --skill profile-investigator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: profile-investigator
Source: https://github.com/lytics/agent-skills/tree/main/profile-investigator
Command: npx skills add https://github.com/lytics/agent-skills --skill profile-investigator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose why a user is or isn't in a segment and trace their data lineage, enabling precise debugging of membership and data provenance.

Core Features & Use Cases

  • Diagnostic exploration of profile membership against segment rules using FilterQL
  • Data lineage retrieval showing data origins across fragments
  • Full profile snapshot with memberships and key attributes for quick auditing

Quick Start

Explain why [email protected] is in a segment and reveal data lineage.

Frequently Asked Questions about profile-investigator

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

FAQPage Schema
How do I diagnose why a specific user is not in a segment?

To diagnose why a user is not in a segment, evaluate their profile data against segment rules using FilterQL. This tool analyzes profile attributes to reveal exactly why segment membership fails.

How can I trace data lineage for a specific user profile?

Trace data lineage by retrieving user profile snapshots that show data origins across fragments. This provides structured reporting on data provenance for auditing and debugging.

What is FilterQL and how does it apply to segment membership debugging?

FilterQL is a query language used to evaluate profile data against segment rules. It enables diagnostic exploration by applying rule-based filters to determine user membership status.

Can I retrieve a full profile snapshot to audit user segment memberships?

Yes, you can retrieve a full profile snapshot containing memberships and key attributes. This provides a quick auditing view of a user's current data and segment status.

Does this tool work with API lookups for identity-based segment questions?

Yes, the tool supports API lookups to resolve identity-based questions. It analyzes profile data against segment rules for a specific user to determine their membership status.

What is the best way to debug data provenance across user profile fragments?

The best way to debug data provenance is to retrieve data lineage showing origins across profile fragments. This structured reporting traces exactly where and how user data originated.