CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rt-setup-triggers

Complete workflow to set up RT 2.0 triggers (RT journeys) from scratch - validates parent segment RT status, discovers event tables and attributes, configures RT infrastructure (events, attributes, ID stitching), creates RT journey with activations. Use when user wants to "create realtime triggers" or "set up RT journey end-to-end".

66

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured orchestrator document: clear step sequence, explicit checkpoints, and mostly executable commands for the journey/activation/launch flow. The main weaknesses are dangling references to steps/ files absent from the bundle, a cross-skill two-level reference chain for Steps 1-7, undefined shell variables, missing error-recovery guidance, and minor duplication.

Suggestions

Ship the referenced steps/01-07-shared-rt-config.md, steps/08-journey-creation.md, steps/09-activation.md, steps/10-journey-config.md, and steps/11-13-launch-verify.md files in the skill bundle (or inline the shared RT config detail) so the links resolve; also flatten the SKILL.md → steps/01-07-shared-rt-config.md → ../rt-setup-personalization/steps/*.md chain to a single level of reference.

Make the quick-summary commands self-contained: show how $JOURNEY_ID, $STAGE_ID, $CONNECTION_ID, and $WEBHOOK_URL are obtained (e.g., capture journey ID from the creation response), and replace Step 7's comment-only block with the actual tdx commands for events, attributes, and ID stitching.

Add error-recovery guidance: bound the poll loops with a timeout and expected failure states (e.g., what to check if RT status stays 'configuring' or the launch PATCH returns an error), and remove the duplicated wait loop and repeated summary checkpoints to tighten the body.

DimensionReasoningScore

Conciseness

The body is lean — quick summaries with concrete commands, no explanations of concepts Claude already knows. Not a 5 because the RT-status wait loop is duplicated verbatim in Steps 7 and 11, and the closing 'Summary' section repeats the per-step checkpoint lists already stated inline.

4 / 5

Actionability

Mostly executable curl/tdx/jq commands with real endpoints and payloads (journey creation, activation, stage configuration, launch, verification). Not a 5 because Step 7's quick summary is comment-only pseudocode ('# Configure event tables, key events, RT attributes, ID stitching' with no actual commands), several variables ($JOURNEY_ID, $STAGE_ID, $CONNECTION_ID, $WEBHOOK_URL) are used without being captured from prior command output, and the poll loops have no timeout or failure path.

4 / 5

Workflow Clarity

Clear 13-step sequence with explicit ✓ checkpoints per step, a verification command with expected output ('Expected: "launched"'), and a wait-for-ready gate before launch. Not a 5 because there is no error-recovery/feedback guidance — if RT status never reaches 'ok' or launch fails, the body gives no fix-and-retry direction, and the while-loops spin indefinitely without a timeout.

4 / 5

Progressive Disclosure

Good signaling pattern (each step section links to a steps/XX.md detail file with an inline quick summary), but the referenced files do not exist in this bundle — there is no steps/ directory, only SKILL.md — so all five 'See [steps/...]' links are dangling. Additionally, Steps 1-7 route through steps/01-07-shared-rt-config.md which itself points to three files in ../rt-setup-personalization/steps/, creating a two-level reference chain. Structure and signaling are present, but unverifiable references and the nested chain keep this below 4.

3 / 5

Total

15

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, third-person enumeration of the end-to-end workflow with an explicit 'Use when...' trigger clause containing natural quoted phrases. Its only weaknesses are keyword coverage slightly short of comprehensive and some trigger-language overlap with the sibling rt-setup-personalization skill.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions covering the whole workflow — 'validates parent segment RT status, discovers event tables and attributes, configures RT infrastructure (events, attributes, ID stitching), creates RT journey with activations' — comprehensive coverage from validation through journey creation. Not a 4 because the actions span the entire end-to-end scope with no significant gaps; uses third person voice.

5 / 5

Completeness

Clearly answers both 'what' (validates parent segment, discovers event tables/attributes, configures RT infrastructure, creates RT journey with activations) and 'when' with explicit concrete trigger phrases ('Use when user wants to "create realtime triggers" or "set up RT journey end-to-end"'). Matches the anchor for both what AND when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural quoted trigger phrases like 'create realtime triggers' and 'set up RT journey end-to-end' plus synonyms (triggers/journeys, RT 2.0/realtime) give good keyword coverage. Not a 5 because common variations users might say (e.g., 'real-time' with hyphen, 'event triggers', 'TD/CDP realtime') are missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche (RT 2.0 journeys/triggers) distinct from generic skills, but the sibling skill rt-setup-personalization shares Steps 1-7 and overlapping 'RT setup' trigger language, creating minor overlap risk when a user just asks to 'set up RT'. Not a 5 due to that closely related sibling; not a 3 because the journey/activation focus is well differentiated from personalization's request-response use case.

4 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 5 missing, 3 suspicious

Warning

Total

15

/

16

Passed

Repository

treasure-data/td-skills

Path

realtime-skills/rt-setup-triggers/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.