CtrlK
BlogDocsLog inGet started
Tessl Logo

rt-config-events

Configure RT 2.0 event tables and key events - define which streaming events to track and filter for real-time processing

57

Quality

65%

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-config-events/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 skill is highly actionable, with executable tdx commands, realistic SQL, and complete API examples throughout. Its weaknesses are repetition across the three vertical example sections, missing validation steps around destructive API operations, and a monolithic single-file structure where example and API content could be split into references.

Suggestions

Consolidate the three near-duplicate vertical example sections into one compact example set (or move them to a references/EXAMPLES.md) to cut repetitive YAML while keeping one exemplar per pattern.

Add explicit validation around destructive and batch operations: list current key events and read the existing realtime_setting before DELETE/PATCH, and verify the event-table config after the PATCH.

Split the API reference detail (key events CRUD, realtime_setting payloads) into a references file and keep SKILL.md as a concise overview with one-level-deep, clearly signaled links.

DimensionReasoningScore

Conciseness

The body is mostly efficient (domain-specific commands, no generic concept explanations), but the three vertical example sections ('E-commerce Event Examples', 'Media/Content Event Examples', 'SaaS/B2B Event Examples') repeat nearly the same YAML filter pattern, and 'Common Patterns' restates examples already shown inline. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'. Not 2 because there is no generic padding or explanation of concepts Claude already knows; not 4 because the triplicated example blocks are a clear trim opportunity.

3 / 5

Actionability

Commands are fully executable and copy-paste ready: discovery ('tdx databases --json', 'tdx table describe events_db web_events'), SQL checks with concrete filters ('regexp_like(td_path, \'^/pageview/\')'), and complete API calls for create/update/delete of key events and event tables. Specific examples cover the common cases, matching the top anchor. Not 4 because there are no material gaps; every section gives runnable commands with realistic values.

5 / 5

Workflow Clarity

Section order implies a sequence (discover tables → define events → validate → key events → next steps) and a 'Validate Event Configuration' section plus a Common Errors table provide some checkpoints. However, destructive/batch operations (DELETE of a key event, wholesale PATCH of realtime_setting replacing event_tables) lack validation/verification steps, which caps workflow clarity at 3 per the scoring notes. Not 4 because no pre-delete or post-update verification and no explicit ordered procedure; not 2 because validation commands and error-recovery guidance do exist.

3 / 5

Progressive Disclosure

The body has clear section headers but is 300+ lines with everything inlined: three vertical example collections, full API payloads, and common-pattern tables that would fit better in separate reference files (e.g., EXAMPLES.md, API.md), and there are no references/scripts/assets files at all. This matches 'some structure but could be better organized... content that should be separate is inline'. Not 2 because structure and navigation via headers are good, not buried; not 4 because substantial reference-worthy content is inlined with no file-level split.

3 / 5

Total

14

/

20

Passed

Description

66%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 is specific and reasonably keyword-rich, clearly conveying what the skill does within the Treasure Data RT 2.0 domain. Its main weakness is the absence of any 'Use when...' trigger guidance, which caps completeness and slightly limits discoverability.

Suggestions

Append an explicit trigger clause, e.g. 'Use when setting up real-time audience triggers, defining which streaming events to track, or when a user mentions RT 2.0 events, key events, or real-time event filtering.'

Add natural synonym phrasings users are likely to say, such as 'event tracking' and 'real-time events', to broaden keyword coverage.

Mention the update/delete lifecycle (managing event tables and key events after creation) so the capability coverage reads as comprehensive rather than creation-only.

DimensionReasoningScore

Specificity

Quotes like "Configure RT 2.0 event tables and key events" and "define which streaming events to track and filter" list several concrete actions (configure, define, track, filter) with only minor gaps (update/delete operations unmentioned), matching the 'lists several specific actions' anchor. Not 5 because coverage is not comprehensive, and not 3 because more than 1-2 concrete actions are named.

4 / 5

Completeness

The 'what' is clear (configure event tables and key events, define which streaming events to track and filter) but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps this dimension at 3 per the judging guidelines. Not 4 because 'when' is entirely absent rather than merely implicit; not 2 because the 'what' is concrete and specific.

3 / 5

Trigger Term Quality

Natural domain keywords are present ("event tables", "key events", "streaming events", "track", "filter", "real-time processing"), giving good coverage, but common user phrasings like "event tracking" or "real-time events" are missing. Better than 3 ('some relevant keywords but missing common variations' is partially true) because most natural terms a Treasure Data user would say are covered; not 5 because synonyms/extensions are incomplete.

4 / 5

Distinctiveness Conflict Risk

The RT 2.0 event-configuration niche is mostly distinct with domain-specific triggers ('RT 2.0 event tables', 'key events'), though it overlaps with closely related sibling skills (rt-config-attributes, rt-journey-create) and 'RT 2.0' is internal jargon unfamiliar to outsiders. Not 5 because of that sibling overlap and jargon reliance; not 3 because the described scope is clearly narrower than generic event processing.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
treasure-data/td-skills
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.