CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rt-triggers

Create RT 2.0 Journeys (Real-Time Triggers) that activate in real-time when specific events occur, triggering activations to external systems via API

53

Quality

67%

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

Fix and improve this skill with Tessl

tessl review fix ./realtime-skills/rt-triggers/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body is highly actionable with executable tdx/curl/SQL examples and a sensible prerequisites → create → test → enable → monitor flow including a debugging feedback loop. Its weaknesses are redundancy across repeated JSON examples and a monolithic single-file structure that inlines API reference and pattern-library content a references/ directory should hold.

Suggestions

Move the API Reference, Common Patterns, and per-activation-type details (webhook/Salesforce/email) into reference files (e.g. references/api.md, references/patterns.md) linked from a lean SKILL.md overview.

De-duplicate the repeated welcome-journey example and the status-check/key-event commands that appear in both Quick Start and Debugging, keeping one canonical version of each.

Wrap the Debugging SQL in an explicit execution command (as done for tdx commands) and standardize on one secret-reference syntax ({{secret:api_key}} vs {{api_key}}).

DimensionReasoningScore

Conciseness

Mostly command/JSON examples with no re-teaching of known concepts, but there is real redundancy: the welcome-journey shape appears three times (Quick Start, RT Journey Structure, Common Patterns), status-check commands repeat in Quick Start and Debugging, and the four Common Patterns largely restate the structure section — more than the 'minor trimming' of anchor 4. Not 2 because nearly all content is concrete API usage Claude would not know, not generic explanation.

3 / 5

Actionability

Concrete, copy-paste-ready guidance throughout: full 'tdx api' commands with complete JSON bodies for create/list/update/delete/enable/disable, curl webhook tests, and SQL log queries covering the common cases. Not 5 because of minor gaps — the Debugging section places bare SQL inside a bash block with no command shown to execute it, and auth templates are inconsistent ('Bearer {{api_key}}' vs 'Bearer {{secret:api_key}}'); not 3 because the guidance is genuinely executable, not pseudocode.

4 / 5

Workflow Clarity

A clear sequence is present — Prerequisites, then Quick Start (check status, list key events, create), then Testing with an explicit 'Test RT journeys before enabling' checkpoint, then enable, then Monitoring, with a Debugging section providing feedback loops (check status, verify key event, view errors). Not 5 because the sequence is implicit in section order rather than an explicit step list and there is no verify-journey-status step after creation; not 3 because an explicit test-before-enable validation checkpoint exists.

4 / 5

Progressive Disclosure

Sections are well-organized with clear headers, but the single ~480-line SKILL.md inlines an API reference, four common-pattern examples, and per-activation-type details that clearly belong in separate reference files; the bundle contains no references/ or scripts/ directories. Not 2 because the content is well-headed and easy to navigate (anchor 2's example is a header-less wall); not 4 because the file is far over the ~50-line simple-skill threshold and much of the bulk should be split out.

3 / 5

Total

14

/

20

Passed

Description

57%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.

The description clearly states what the skill does with domain-appropriate terminology, but it lacks any 'use when' trigger guidance and describes only one capability rather than enumerating the distinct activation types (webhook, email, Salesforce) the skill supports. It is reasonably distinct within its niche but does not distinguish itself from the sibling batch-journey skill.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user mentions RT journeys, real-time triggers, event-triggered activations, or wants to fire webhooks/emails when events occur.'

Enumerate the concrete activation capabilities (webhook, email, Salesforce) and event filtering to lift specificity beyond a single circular action phrase.

Add a boundary cue such as 'For stage-based batch journeys, use the journey skill' so 'journey' requests route to the correct skill.

DimensionReasoningScore

Specificity

Names the domain and 1-2 concrete actions ('Create RT 2.0 Journeys', 'triggering activations to external systems via API'), but all actions describe a single capability with circular phrasing ('activate in real-time... triggering activations') and no distinct sub-actions like webhook, email, or Salesforce activations. Not 4 because it does not list several specific distinct actions; not 2 because the actions named are concrete, not generic.

3 / 5

Completeness

Has a clear 'what' (create event-triggered real-time journeys that send activations to external systems via API) but no 'Use when...' clause or equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. Not 4 because the 'when' is entirely absent rather than just implicit; not 2 because the 'what' is clear and specific.

3 / 5

Trigger Term Quality

Includes the natural domain vocabulary a user would say — 'RT 2.0 Journeys', 'Real-Time Triggers', 'real-time', 'specific events', 'external systems', 'API' — which is good keyword coverage. Not 5 because common variations like 'webhook', 'event-driven', or 'event-triggered' are missing; not 3 because the core product names and the most natural phrases are present.

4 / 5

Distinctiveness Conflict Risk

'RT 2.0 Journeys (Real-Time Triggers)' is niche terminology, but 'Journeys' overlaps with the closely related Batch Journeys skill and the description gives no signal of that boundary — a user asking to 'create a journey' could match either skill. Not 4 because the RT-vs-batch distinction is not conveyed in the description itself; not 2 because the real-time/event-triggered qualifiers do narrow it considerably.

3 / 5

Total

13

/

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: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

treasure-data/td-skills

Path

realtime-skills/rt-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.