How do I install the Validate Segment skill?

Run npx skillmds@latest add majiayu000/validate-segment in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Validate Segment safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Validate Segment?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Validate Segment free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Validate Segment?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Validate Segment by majiayu000 — Agent Skill

Name: Validate Segment
Rating: 4.2 (5 reviews)
Author: majiayu000

Validate Segment

Validates CDP segment YAML configurations against the TD CDP API specification. Use when reviewing segment rules for correctness, checking operator types and values, or troubleshooting segment configuration errors before pushing to Treasure Data.

majiayu000 Updated Sep 9, 2026 567 repo stars

File contents

Segment YAML Validation

tdx sg validate                           # Validate all YAML files locally
tdx sg validate path/to/segment.yml       # Validate specific file
tdx sg push --dry-run                     # Preview changes before push

Required Structure

name: string
kind: batch                    # batch | realtime | funnel_stage
rule:
  type: And                    # And | Or
  conditions:
    - type: Value
      attribute: field_name
      operator:
        type: OperatorType
        value: ...

Operators Quick Reference

Type	Value	Notes
`Equal`, `NotEqual`	single value
`Greater`, `GreaterEqual`, `Less`, `LessEqual`	number
`In`, `NotIn`	array	`["US", "CA"]`
`Contain`, `StartWith`, `EndWith`	array	`["@gmail.com"]`
`Regexp`	string	regex pattern
`IsNull`	(none)
`TimeWithinPast`, `TimeWithinNext`	number + unit	`value: 30, unit: day`
`include`, `exclude`	segment name	reuse existing segment

Time Units (Singular Form Only)

year | quarter | month | week | day | hour | minute | second

Common mistake: days → day, months → month

Behavior Aggregation Structure

# Behavior condition with aggregation
- type: Value
  attribute: field_name          # Or "" for pure count
  operator:
    type: GreaterEqual
    value: 1
  aggregation:
    type: Count                  # Count | Sum | Avg | Min | Max
  source: behavior_name          # Behavior from parent segment

Required fields: aggregation.type and source must both be present

Related Skills

segment - Full segment management

---name: validate-segmentdescription: Validates CDP segment YAML configurations against the TD CDP API specification. Use when reviewing segment rules for correctness, checking operator types and values, or troubleshooting segment configuration errors before pushing to Treasure Data.--- # Segment YAML Validation ```bash tdx sg validate # Validate all YAML files locally tdx sg validate path/to/segment.yml # Validate specific file tdx sg push --dry-run # Preview changes before push ``` ## Required Structure ```yaml name: string kind: batch # batch | realtime | funnel_stage rule: type: And # And | Or conditions: - type: Value attribute: field_name operator: type: OperatorType value: ... ``` ## Operators Quick Reference | Type | Value | Notes | |------|-------|-------| | `Equal`, `NotEqual` | single value | | | `Greater`, `GreaterEqual`, `Less`, `LessEqual` | number | | | `In`, `NotIn` | array | `["US", "CA"]` | | `Contain`, `StartWith`, `EndWith` | array | `["@gmail.com"]` | | `Regexp` | string | regex pattern | | `IsNull` | (none) | | | `TimeWithinPast`, `TimeWithinNext` | number + unit | `value: 30, unit: day` | | `include`, `exclude` | segment name | reuse existing segment | ## Time Units (Singular Form Only) ``` year | quarter | month | week | day | hour | minute | second ``` **Common mistake**: `days` → `day`, `months` → `month` ## Behavior Aggregation Structure ```yaml # Behavior condition with aggregation - type: Value attribute: field_name # Or "" for pure count operator: type: GreaterEqual value: 1 aggregation: type: Count # Count | Sum | Avg | Min | Max source: behavior_name # Behavior from parent segment ``` **Required fields**: `aggregation.type` and `source` must both be present ## Related Skills - **segment** - Full segment management

Frequently asked questions