rev-ops:csql-tracking

Track CSQL lifecycle stages with state-machine guards and portfolio queries.

58|21|Updated May 15, 2026
One-click install
npx skills add https://github.com/t0ddc3by/claude-for-customer-success --skill rev-ops-csql-tracking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rev-ops:csql-tracking
Source: https://github.com/t0ddc3by/claude-for-customer-success/tree/main/rev-ops/skills/csql-tracking
Command: npx skills add https://github.com/t0ddc3by/claude-for-customer-success --skill rev-ops-csql-tracking

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It manages the full lifecycle of Customer Success Qualified Leads (CSQLs) so RevOps can reliably create, update, close, and query expansion leads from a qualification handoff into a single source of truth.

Core Features & Use Cases

  • CSQL lifecycle tracking: Log new CSQLs, progress them through pipeline stages, and close them as won, lost, or stalled.
  • State-machine enforced updates: Prevent invalid stage changes and lock terminal records to preserve deal history integrity.
  • Read-only portfolio reporting: Query active and (optionally) closed CSQLs with filtering and sorting for expansion pipeline visibility.
  • Inter-skill contract consumption: Uses CSQL Qualification Packages emitted by csm:expansion-business-case [mode=csql] and persists them for downstream reporting and handoffs.

Quick Start

Log a CSQL for Acme Corp by providing the qualification package, expansion product, estimated ARR, owning CSM, and (optionally) the AE owner.

Frequently Asked Questions about rev-ops:csql-tracking

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

FAQPage Schema
How do I track Customer Success Qualified Leads through the pipeline to close?

Track Customer Success Qualified Leads by logging new records, progressing them through pipeline stages via state-machine enforced updates, and closing them as won, lost, or stalled. Filesystem-persisted record versioning preserves deal history integrity.

What is a CSQL Qualification Package and when do I need it for expansion pipeline reporting?

A CSQL Qualification Package is the upstream CS handoff data required to log a new Customer Success Qualified Lead. You need it to create a reliable single source of truth for expansion pipeline reporting and downstream handoffs.

Can I prevent invalid stage changes when updating expansion leads?

Yes, state-machine enforced updates prevent invalid stage changes for expansion leads and lock terminal records. This controlled write behavior ensures CSQL lifecycle integrity from creation through terminal close.

How do I query active and closed CSQLs for portfolio reporting?

Query active and optionally closed CSQLs using read-only portfolio operations with filtering and sorting. This provides expansion pipeline visibility across your tracked Customer Success Qualified Leads.

What information do I need to provide to log a new CSQL for an account?

To log a new CSQL, provide the qualification package, expansion product, estimated ARR, owning CSM, and optionally the AE owner. These fields establish the immutable identity for the tracked lead.

Why are terminal CSQL records locked and how does this preserve deal history?

Terminal CSQL records are locked to preserve deal history integrity by preventing further modifications after closure. Filesystem-persisted record versioning and state-machine guards enforce this controlled write behavior.