# Supported Skills Catalog This catalog lists the skills delivered by the **tdx-skills** plugin — the plugin Treasure AI Studio enables by default, so these skills are available in every account out of the box. Use it to find the right skill for your task, understand what each one does, and know which user personas benefit most. Beyond the default plugin The **tdx-skills** plugin is one of several in the pre-installed **td-skills** marketplace. Other plugins — SQL query skills, workflow authoring, real-time personalization, document generation, and more — are available but not enabled by default. Enable them in **Settings → Marketplace**; see [Plugin Marketplace](/products/ai-studio/skills/marketplace). This page covers only the default tdx-skills plugin. ## Objective Provide a complete reference of the skills in the default tdx-skills plugin so users can identify the right skill for their task without trial and error. ## Prerequisites - Familiarity with how skills work ([Skills & Marketplace](/products/ai-studio/skills/skills)) - Signed in to Treasure AI Studio ([Getting Started](/products/ai-studio/getting-started)) ## How to Read This Catalog Each skill entry includes: | Field | Meaning | | --- | --- | | **Skill Name** | The skill's name as it appears in the plugin (for example, `segment`) | | **Description** | What the skill teaches the AI to do | | **Key Capabilities** | Specific tasks the skill enables | | **Target Persona** | Who benefits most — though the AI applies any relevant skill regardless of your role | **Persona Key:** | Label | Role | | --- | --- | | Data Analyst | Writes queries, explores data, builds reports | | Data Engineer | Builds pipelines, manages workflows, optimizes infrastructure | | Marketer | Manages segments, journeys, campaigns, and activations | | CDP Admin | Configures parent segments, manages audience architecture | | Solutions Engineer | Implements end-to-end solutions, validates configurations | | Developer | Builds agents, integrations, and applications | | All Users | Universal — useful regardless of role | ## CDP & Segments Build, validate, and analyze CDP parent and child segments. | Skill Name | Description | Key Capabilities | Target Persona | | --- | --- | --- | --- | | **parent-segment** | Manage CDP parent segments with `tdx ps` and YAML configs | Master table configuration, attribute and behavior definitions, `tdx ps validate` for join validation, `tdx ps preview` for data preview, schedule configuration (daily/hourly/cron) | CDP Admin, Solutions Engineer | | **segment** | Manage CDP child segments with `tdx sg` and YAML rule configs | Value and Behavior condition types, all operators (Equal, In, Between, TimeWithinPast, and more), behavior aggregations with filters, nested condition groups, field discovery with `tdx sg fields` | Marketer, CDP Admin | | **validate-segment** | Validation reference for CDP segment YAML | All 18 operator types with required fields, error code reference, troubleshooting for `tdx sg validate` and `tdx sg push --dry-run`, behavior condition structure checks | Solutions Engineer | | **parent-segment-analysis** | Query and analyze CDP parent segment output data | Output database schema discovery with `tdx ps desc -o`, customer and behavior table querying, attribute and behavior exploration, report building | Data Analyst | **When to use segment skills:** - **For Marketers:** Use **segment** to build audience rules in natural language. Say "create a segment of users who visited the pricing page in the last 7 days and haven't purchased" and the AI drafts the segment definition in the correct YAML schema for you to review against your intent before pushing. - **For CDP Admins:** Start with **parent-segment** to set up the foundation, then use **segment** for child segments. Add **validate-segment** when debugging validation errors. - **For Data Analysts:** Use **parent-segment-analysis** to explore customer and behavior data in parent segment output tables. ## Journeys & Activations Design customer journeys and configure activation connectors. | Skill Name | Description | Key Capabilities | Target Persona | | --- | --- | --- | --- | | **journey** | Create, edit, and manage CDP customer journeys | Journey YAML with segments, activations, and stage steps (wait, activation, decision_point, ab_test, merge, jump, end), flow logic, pushing changes, and journey performance analysis, tables, and reports | Marketer | | **validate-journey** | Validation reference for CDP journey YAML | Error codes by category, step type requirements and parameters, segment references, flow control rules (merge, branching, convergence) | Solutions Engineer | | **connector-config** | Write `connector_config` for segment and journey activations | Field discovery with `tdx connection schema `, connector field mapping, activation configuration for supported connection types | Solutions Engineer | **When to use journey and activation skills:** - **For Marketers:** Use **journey** to describe a customer flow in plain language, and the AI drafts a journey definition for you to review against your intent before pushing. - **For Solutions Engineers:** Add **validate-journey** to debug journey errors, and **connector-config** to configure activation connectors after discovering their fields. ## Campaigns Build and deploy Treasure Engage email and push campaigns. | Skill Name | Description | Key Capabilities | Target Persona | | --- | --- | --- | --- | | **engage** | Manage Treasure Engage email templates and campaigns with `tdx engage` | Workspace management, email and push campaign configuration with YAML + HTML, template creation and editing, preview, validation, and deployment | Marketer | **When to use the engage skill:** - **For Marketers:** Use **engage** to create, preview, and deploy email and push campaigns. Describe the campaign and the AI drafts a YAML definition alongside the HTML content for you to preview and validate before pushing. ## AI Agents Build, test, and deploy agents on AI Agent Foundry. | Skill Name | Description | Key Capabilities | Target Persona | | --- | --- | --- | --- | | **foundry-agent** | Build AI Agent Foundry agents with `tdx agent pull/push` | `agent.yml` structure, tool configuration (knowledge_base, agent, web_search, image_gen), `@ref` syntax, knowledge base setup, YAML/Markdown authoring | Solutions Engineer, Developer | | **foundry-agent-prompt** | Write effective system prompts for AI Agent Foundry agents | Role definition, constraint specification, output formatting, tool usage instructions, prompt structure patterns | Solutions Engineer | | **foundry-agent-test** | Run automated tests for AI Agent Foundry agents with `tdx agent test` | `test.yml` format with `user_input`/`criteria`, single and multi-round tests, judge agent evaluation, criteria development workflow | Solutions Engineer | **When to use agent skills:** - **For Solutions Engineers and Developers:** Use all three as a set. Build with **foundry-agent**, write the system prompt with **foundry-agent-prompt**, and validate with **foundry-agent-test**. See [AI Agent Foundry](/products/customer-data-platform/ai-agent-foundry) for the product these agents run on. ## Workflows Manage Treasure Workflows via the `tdx` CLI. | Skill Name | Description | Key Capabilities | Target Persona | | --- | --- | --- | --- | | **workflow** | Manage Treasure Workflows with `tdx wf` commands | Project sync (`pull`/`push`/`clone`), running workflows, session and attempt monitoring, task timeline visualization, retry and kill operations, secrets management | Data Engineer | **When to use the workflow skill:** - **For Data Engineers:** Use **workflow** for the full workflow lifecycle — syncing projects, running workflows, monitoring execution, debugging failures, and retrying tasks. ## CLI Core CLI operations for managing Treasure AI resources. | Skill Name | Description | Key Capabilities | Target Persona | | --- | --- | --- | --- | | **tdx-basic** | Execute core `tdx` CLI commands | `tdx databases`, `tdx tables`, `tdx describe`, and `tdx query`; authentication setup with `tdx auth setup`; context management with profiles and sessions; output formats (JSON/TSV/table) | All Users | **When to use the CLI skill:** - **For all users:** The **tdx-basic** skill is a good baseline — it helps the AI construct correct CLI commands for database and table exploration, schema inspection, query execution, and authentication. ## Quick Reference: Skills by Persona Find the skills most relevant to your role: ### Data Analysts | Skill | Why | | --- | --- | | parent-segment-analysis | Explore customer and behavior data in parent segment output tables | | tdx-basic | Core CLI operations for database exploration and queries | ### Data Engineers | Skill | Why | | --- | --- | | workflow | Full workflow lifecycle — sync, run, monitor, debug, retry | | tdx-basic | CLI-driven data operations and resource management | ### Marketers | Skill | Why | | --- | --- | | segment | Build audience segments in natural language | | journey | Design customer journeys with stages and activations | | engage | Create and deploy email and push campaigns | ### CDP Admins | Skill | Why | | --- | --- | | parent-segment | Set up and manage CDP parent segment foundations | | segment | Build and manage child segments | ### Solutions Engineers | Skill | Why | | --- | --- | | parent-segment | Set up CDP foundations for client implementations | | validate-segment, validate-journey | Debug configuration and validation errors | | connector-config | Configure activation connectors | | foundry-agent, foundry-agent-prompt, foundry-agent-test | Full agent development lifecycle | ### Developers | Skill | Why | | --- | --- | | foundry-agent, foundry-agent-prompt, foundry-agent-test | Build, prompt, and test AI Agent Foundry agents | ### All Users | Skill | Why | | --- | --- | | tdx-basic | Core CLI operations every user needs | ## Skill Availability by Platform The tdx-skills plugin applies on every platform, but plugin management differs: | Capability | Web | Desktop (Mac) | Mobile (iOS) | | --- | --- | --- | --- | | Skills applied in AI responses | Yes | Yes | Yes | | Enable or disable plugins (Settings → Marketplace) | Yes | Yes | -- | | Register additional marketplaces | Yes | Yes | -- | Mobile Plugin management is Web and Desktop only. Plugins you enable there — including tdx-skills — apply to your Mobile conversations automatically. ## Verification After reading this catalog, you can: - [ ] Identify which skills to activate for a CDP segment-to-journey workflow - [ ] Name the skills a Solutions Engineer needs to build and test an AI Agent Foundry agent - [ ] Explain the difference between **segment** and **validate-segment** - [ ] Find the right skill for managing a Treasure Engage campaign - [ ] Explain that these skills come from the default tdx-skills plugin, and where to find others ## Troubleshooting | Issue | Solution | | --- | --- | | A skill I expected isn't listed here | This catalog covers only the default tdx-skills plugin. SQL, workflow-authoring, real-time, and document skills live in other plugins — enable them in **Settings → Marketplace** (see [Plugin Marketplace](/products/ai-studio/skills/marketplace)) | | A skill is available but the AI doesn't use it | Skills provide context — the AI decides when to apply them. Make your prompt more specific so it clearly matches the skill's domain (for example, "build a segment for users who purchased last week" for the segment skill) | ## Next Steps - [Skills & Marketplace](/products/ai-studio/skills/skills) — Learn how skills work and how the AI applies them - [Plugin Marketplace](/products/ai-studio/skills/marketplace) — Enable additional plugins and register marketplaces - [TDX Commands](/products/ai-studio/query/tdx-commands) — Run the CLI commands that these skills generate