ReddRadar
Agent skill
workflow
Manages TD workflows using `tdx wf` commands. Covers project sync (pull/push/clone), running workflows, monitoring sessions/attempts, task timeline visualization, retry/kill operations, and secrets management. Use when users need to manage, monitor, or debug Treasure Workflow projects via tdx CLI.
Install this agent skill to your Project
npx add-skill https://github.com/treasure-data/td-skills/tree/main/tdx-skills/workflow
SKILL.md
tdx wf - Workflow Commands
Project Context
tdx wf use my_project # Set default project for session
tdx wf use --clear # Clear project context
tdx status # Verify current context
All commands below use session context when project argument is omitted.
Discovery
tdx wf projects # List all projects
tdx wf projects "prod_*" # Filter with glob pattern
tdx wf workflows # List workflows in current project
tdx wf workflows my_project # List workflows in specific project
Project Sync
# Pull → edit locally → push (recommended workflow)
tdx wf pull my_project # Pull to workflows/my_project/
tdx wf pull my_project ./custom-dir # Pull to custom directory
tdx wf pull my_project --revision r1 # Pull specific revision
tdx wf pull my_project --dry-run # Preview without writing files
tdx wf push # Push local changes with diff preview
tdx wf push --skip-validation # Skip .dig file validation
tdx wf push --revision "v2.0" # Custom revision name
# Clone & manage
tdx wf clone --name my_project_prod # Clone project to new name
tdx wf delete my_project # Delete project from TD
tdx wf download my_project # Download without sync tracking (legacy)
tdx wf upload my_project # Upload without sync tracking (legacy)
Running Workflows
tdx wf run # Interactive selector
tdx wf run my_project.my_workflow # Run specific workflow
tdx wf run my_project.wf --param key=value # With parameters (repeatable)
tdx wf run my_project.wf --session-time 2025-01-01T00:00:00+00:00 # Custom session time
Monitoring Sessions
tdx wf sessions # List recent sessions
tdx wf sessions my_project # Filter by project
tdx wf sessions --status error # Filter: running, success, error, blocked, all
tdx wf sessions --from 2025-01-01 # Filter by start time (ISO 8601)
tdx wf sessions --to 2025-01-31 # Filter by end time
Monitoring Attempts
tdx wf attempts # List recent attempts
tdx wf attempts my_project # Filter by project
tdx wf attempts --include-retried # Include retried attempts
Task Timeline
Visual Gantt chart of task execution within an attempt:
tdx wf timeline my_project.workflow # Show timeline for latest attempt
tdx wf timeline --follow # Watch running attempt in real-time
tdx wf timeline --attempt-id <id> # Timeline for specific attempt
tdx wf timeline --session-id <id> # Timeline for specific session
Interactive mode: tdx wf sessions lets you select a session to jump into its task timeline.
Attempt Actions
tdx wf attempt <id> tasks # Show task status tree
tdx wf attempt <id> tasks --include-subtasks # Include subtasks
tdx wf attempt <id> logs +task_name # View task logs
tdx wf attempt <id> retry # Retry from start
tdx wf attempt <id> retry --resume-from +step # Resume from specific task
tdx wf attempt <id> retry --params '{"key":"val"}' # Override parameters
tdx wf attempt <id> retry --force # Force retry even if not failed
tdx wf attempt <id> kill # Stop running attempt
tdx wf attempt <id> kill --reason "fixing bug" # Kill with reason
Retry by Session
tdx wf retry session:<session-id> # Retry a session
tdx wf retry session:<id> --from-task +step # Resume from task
tdx wf retry session:<id> --params '{"k":"v"}' # Override parameters
Secrets
tdx wf secrets list # List secret keys (values hidden)
tdx wf secrets set KEY=value # Set a secret
tdx wf secrets set my_project KEY=v # Set for specific project
tdx wf secrets delete KEY # Delete a secret
Usage in .dig files: ${secret:KEY}
Debugging Workflow
tdx wf sessions --status error- find failed sessionstdx wf timeline --session-id <id>- visualize task executiontdx wf attempt <id> tasks- identify failed tasktdx wf attempt <id> logs +failed_task- read error logstdx wf attempt <id> retry --resume-from +failed_task- retry from failure point
Output Formats
All list commands support --json, --jsonl, --tsv, --table flags and --output <file>.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
treasure-data/td-skills
email-campaign
This skill should be used when the user asks to "create an email", "build an email campaign", "design an email template", "generate an email for a segment", "preview an email", or "push an email to Engage". Generates enterprise-grade HTML email templates with live preview in Treasure Studio and natural language editing, then pushes the final version to Treasure Engage.
treasure-data/td-skills
action-report
YAML format reference for action reports rendered via preview_action_report. MUST be read before writing any action report YAML — defines the report structure (title, summary, actions array) and action item fields (as_is, to_be, reason, priority, category, impact) with incremental build workflow. Required by seo-analysis and any skill that produces prioritized recommendations.
treasure-data/td-skills
grid-dashboard
YAML format reference for grid dashboards rendered via preview_grid_dashboard. MUST be read before writing any dashboard YAML — defines the page structure, 6 cell types (kpi, gauge, scores, table, chart, markdown), grid layout rules, cell merging syntax, and incremental build workflow. Required by seo-analysis and any skill that produces visual data dashboards.
treasure-data/td-skills
seo-analysis
Runs SEO and AEO (Answer Engine Optimization) analysis on websites or specific pages. Use when the user mentions SEO, AEO, search rankings, search optimization, or wants to analyze how their pages perform in search engines and AI answers. Produces a data dashboard and action report with before/after recommendations.
treasure-data/td-skills
aps-doc-core
Core documentation generation patterns and framework for Treasure Data pipeline layers. Provides shared templates, quality validation, testing framework, and Confluence integration used by all layer-specific documentation skills.
treasure-data/td-skills
aps-doc-id-unification
Expert documentation generation for ID unification layers. Documents identity resolution algorithms, merge strategies, match rules, entity graphs, and multi-workflow orchestration. Use when documenting ID unification processes.
Didn't find tool you were looking for?