Agent skill

Segmentation Framework

by gtmagents in gtmagents/gtm-agents

A skill your agent uses to design and document customer segments with clear criteria, metrics, and governance.

Apache-2.0Auto-check passed

Install Segmentation Framework

skills CLI
$ npx skills add gtmagents/gtm-agents --skill segmentation-framework -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gtmagents/gtm-agents segmentation-framework --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gtmagents/gtm-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/customer-analytics/skills/segmentation-framework .claude/skills/segmentation-framework && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
segmentation-framework
GitHub stars
413
Used in
1 other repo
Token cost
~303 tokens
SKILL.md length
131 words
Files
1
Skills in repo
127
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses to design and document customer segments with clear criteria, metrics, and governance.

  • Works in 5 steps: Objective & KPIs – clarify why… → Data Inputs – list sources… → Segmentation Logic – outline… → …
  • Design and document customer segments with clear criteria
  • SKILL.md covers When to Use, Framework, Templates and Tips
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Segmentation Framework is an agent skill from gtmagents/gtm-agents. Use to design and document customer segments with clear criteria, metrics, and governance.

Its SKILL.md is about 300 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Production-ready collection of GTM agents and specialized skills for claude code. Covers sales, marketing, customer success, and revenue operations workflows. The licence is Apache-2.0.

When your agent uses it

  • Design and document customer segments with clear criteria

Example prompts

  • “/segmentation-framework”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Objective & KPIs – clarify why segmentation is needed and how it will be measured.
  2. Data Inputs – list sources (firmographic, technographic, usage, revenue, intent) and required freshness.
  3. Segmentation Logic – outline rules/cluster definitions, decision trees, and scoring weights.
  4. Validation Checklist – sample accounts, lift vs KPIs, stakeholder review.
  5. Governance – refresh cadence, change management process, and owner roster.

What it can do on your machine

Read from SKILL.md and the folder at commit 78e0419. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Segmentation Framework loads about 303 tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 131 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~28
When it runs · the whole SKILL.md, loaded when a task matches
~303

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from gtmagents/gtm-agents at commit 78e0419, republished under its Apache-2.0 licence (© gtmagents). 131 words, ~303 tokens.

Download SKILL.mdSave it as .claude/skills/segmentation-framework/SKILL.md (or your agent's skills folder).
name
segmentation-framework
description
Use to design and document customer segments with clear criteria, metrics, and governance.

Segmentation Framework Skill

When to Use

  • Building or refreshing customer personas for marketing, sales, or product usage.
  • Aligning RevOps/data teams on scoring logic.
  • Preparing documentation for GTM activation or reporting.

Framework

  1. Objective & KPIs – clarify why segmentation is needed and how it will be measured.
  2. Data Inputs – list sources (firmographic, technographic, usage, revenue, intent) and required freshness.
  3. Segmentation Logic – outline rules/cluster definitions, decision trees, and scoring weights.
  4. Validation Checklist – sample accounts, lift vs KPIs, stakeholder review.
  5. Governance – refresh cadence, change management process, and owner roster.

Templates

  • Segmentation spec (definition, logic, KPIs, owner).
  • Scoring weight table + calculator.
  • Adoption tracker + feedback log.

Tips

  • Start with simple rules before layering complex clustering.
  • Document exclusions and fallback logic for incomplete data.
  • Pair with activation-map to ensure each segment has downstream plays.

© gtmagents, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/customer-analytics/skills/segmentation-framework of gtmagents/gtm-agents.

Open the folder on GitHubat commit 78e0419

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in gtmagents/gtm-agents, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Segmentation Framework next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Segmentation Framework compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Segmentation Framework this skillgtmagents/gtm-agents4131 repos~303Automated safety check: PassApache-2.0
Custom Distance Metricsbenchflow-ai/skillsbench1.8k—~674Automated safety check: PassApache-2.0
Customer Segment Slicinghashgraph-online/awesome-codex-plugins1.2k—~807Automated safety check: PassMIT
North Star Metricphuryn/pm-skills27k—~1kAutomated safety check: PassMIT
Investigate MetricPostHog/posthog40k—~1.9kAutomated safety check: PassCustom licence
Product Metrics Dashboard Designphuryn/pm-skills27k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Custom Distance Metrics

    benchflow-ai/skillsbench

    Define custom distance/similarity metrics for clustering and ML algorithms.

    1.8k GitHub stars~674 tokensUpdated 2 mo ago
    Data & AnalyticsAuto-check passed
  • Customer Segment Slicing

    hashgraph-online/awesome-codex-plugins

    Narrow broad customer categories into specific, reachable who-where segments for customer discovery, positioning, traction tests, sales outreach, or SEO personas.

    1.2k GitHub stars~807 tokensUpdated today
    Sales & SupportAuto-check passed
  • North Star Metric

    phuryn/pm-skills

    Define a North Star Metric and 3-5 supporting input metrics that form a metrics constellation.

    27k GitHub stars~1k tokensUpdated 23 days ago
    Product & Project ManagementAuto-check passed
  • Investigate Metric

    PostHog/posthog

    Official

    Diagnose why a product metric changed (dropped, spiked, or plateaued) by orchestrating breakdowns, actors, paths, lifecycle, retention, and annotations queries.

    40k GitHub stars~1.9k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Designs a product metrics dashboard: a North Star and input metrics, a definition table with data sources, chart types and alert thresholds, and a screen layout.

    27k GitHub stars~1.3k tokensUpdated 23 days ago
    Product & Project ManagementAuto-check passed
  • Customize

    anthropics/claude-for-legal

    Official

    Guided customization of your IP practice profile — change one thing without re-running the whole cold-start interview.

    9.6k GitHub starsUsed in 4 repos~1.2k tokens
    Legal & ComplianceAuto-check passed

More from gtmagents/gtm-agents

All 127 skills in this repo
  • Enrichment Data Sourcing

    gtmagents/gtm-agents

    Chooses and orders data providers for email, phone, company and intent enrichment, with waterfall sequences and credit-saving tactics across 150+ sources.

    413 GitHub starsUsed in 2 repos~2.4k tokens
    Auto-check passed
  • Cold Email Personalization

    gtmagents/gtm-agents

    Writes personalized B2B cold emails from prospect research, using a gated workflow, a quality rubric and follow-up sequences.

    413 GitHub starsUsed in 1 repo~853 tokens
    Auto-check passed
  • Discovery Call Playbook

    gtmagents/gtm-agents

    Structures sales discovery calls with a PREP routine, a five-part call flow, a question bank, a qualification scorecard and a follow-up recap email.

    413 GitHub starsUsed in 1 repo~368 tokens
    Auto-check passed
  • Frames marketing automation around lifecycle stages, signals, touches and SLAs, with worksheets for onboarding, expansion, renewal and churn-prevention journeys.

    413 GitHub starsUsed in 1 repo~927 tokens
    Auto-check passed
  • Social Selling

    gtmagents/gtm-agents

    A skill your agent uses when engaging prospects through LinkedIn, communities, and social channels to spark warm conversations and meetings.

    413 GitHub starsUsed in 1 repo~431 tokens
    Auto-check passed
  • Drip Campaigns

    gtmagents/gtm-agents

    A skill your agent uses when you need to map sequenced nurture flows with pacing, storytelling arcs, and value ladders.

    413 GitHub starsUsed in 1 repo~310 tokens
    Auto-check passed

Questions about Segmentation Framework

What does Segmentation Framework do?

A skill your agent uses to design and document customer segments with clear criteria, metrics, and governance. Segmentation Framework is an agent skill from gtmagents/gtm-agents. Use to design and document customer segments with clear criteria, metrics, and governance.

When should I use Segmentation Framework?

Segmentation Framework fits situations like: design and document customer segments with clear criteria.

How do I install Segmentation Framework in Claude Code?

Run `npx skills add gtmagents/gtm-agents --skill segmentation-framework -a claude-code`. Or copy the skill folder (plugins/customer-analytics/skills/segmentation-framework in gtmagents/gtm-agents) into .claude/skills/segmentation-framework in your project. Claude Code loads it when a task matches its description.

How do I install Segmentation Framework in Codex?

Run `npx skills add gtmagents/gtm-agents --skill segmentation-framework -a codex`. Or copy the skill folder (plugins/customer-analytics/skills/segmentation-framework in gtmagents/gtm-agents) into .agents/skills/segmentation-framework in your project. Codex loads it when a task matches its description.

Can I use Segmentation Framework in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gtmagents/gtm-agents --skill segmentation-framework -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/segmentation-framework, .gemini/skills/segmentation-framework, .github/skills/segmentation-framework and .opencode/skills/segmentation-framework in your project.

What does Segmentation Framework need to run?

SKILL.md names no scripts, command-line tools or credentials: Segmentation Framework is instructions for the agent only.

Does Segmentation Framework access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Segmentation Framework safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Segmentation Framework use?

Segmentation Framework is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Segmentation Framework use?

About 303 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Segmentation Framework?

Skills that share tags, products or a category with Segmentation Framework: Custom Distance Metrics (benchflow-ai/skillsbench, 1.8k stars), Customer Segment Slicing (hashgraph-online/awesome-codex-plugins, 1.2k stars), North Star Metric (phuryn/pm-skills, 27k stars) and Investigate Metric (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Segmentation Framework?

gtmagents (a GitHub user) maintains it in gtmagents/gtm-agents, which has 413 GitHub stars. The repository holds 127 skills in this directory. The repository was last updated on April 3, 2026.

Source: gtmagents/gtm-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.