CtrlK
BlogDocsLog inGet started
Tessl Logo

rt-config-setup

Initial RT 2.0 setup - check enablement status, initialize configuration, and verify prerequisites for parent segments

60

Quality

70%

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

Quality

Content

82%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 content is a strong, execution-oriented skill: concrete commands with expected outputs, a realistic config template, an explicit validate-before-push workflow, and an error table. Weaknesses are mild — a repeated `tdx ps view` snippet across four sections, duplicated skill handoffs, and an implicit rather than explicit error-recovery loop.

DimensionReasoningScore

Conciseness

The body is dominated by executable commands with informative comments and contains no explanation of concepts Claude already knows. Minor trimming is available: `tdx ps view <parent_segment_id> --json` is repeated across the Check RT Status, Initialize, Update, and Verification sections, and the rt-config-events/attributes/id-stitching trio is listed twice (Configuration Workflow and Next Steps). This places it at anchor 4 (efficient, minor over-explanation to trim) rather than anchor 5's every-token-earns-its-place, but well above anchor 3's noticeable padding.

4 / 5

Actionability

Guidance is copy-paste ready throughout: concrete `tdx` commands with placeholders, expected JSON responses for both enabled and not-enabled states, a ready-to-send enablement request template, a full `rt_config.yaml` example, and a Common Errors table mapping each error to a specific fix. Anchor 5's "fully executable; specific examples cover the common cases" matches exactly; anchor 4 would imply missing details that are not missing.

5 / 5

Workflow Clarity

The 9-step Configuration Workflow provides a clear sequence with an explicit Validate step before Push and a Verify step at the end, and push status values ("ok"/"updating"/"error") give a monitoring checkpoint. It sits at anchor 4 rather than 5 because the error-recovery feedback loop is implicit — the Common Errors table suggests fixes but the workflow never instructs "if validation or push fails, fix and re-validate before proceeding."

4 / 5

Progressive Disclosure

The skill has no bundle files (no references/, scripts/, or assets/ directories), and the single SKILL.md is well-sectioned (Prerequisites, Check Status, Initialize, Validate, Push, Verify, Common Errors, Next Steps) with clearly signaled handoffs to sibling skills (rt-config-events, rt-config-attributes, rt-config-id-stitching, rt-journey-create, rt-pz-service). This matches anchor 4's good structure with minor organization gaps; it is not a 5 because ~230 lines of template and email content all live inline with no split into reference files.

4 / 5

Total

17

/

20

Passed

Description

58%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 states its purpose with three concrete, domain-anchored actions but omits any "Use when..." trigger guidance, which both caps completeness and weakens the natural keyword coverage users would rely on to invoke it. Distinctiveness within the RT 2.0 skill family is reasonably good thanks to the "Initial ... setup" framing.

Suggestions

Add an explicit trigger clause, e.g. "Use when initially setting up RT 2.0 for a parent segment, checking RT enablement status, or creating an RT configuration template."

Include natural synonyms users would actually say — "real-time personalization", "RT enablement", "realtime config" — to improve trigger term coverage.

Make the third action as concrete as the first two by replacing "verify prerequisites" with what is actually checked (e.g., "confirm tdx CLI access and master API key permissions").

DimensionReasoningScore

Specificity

The description lists three explicit actions — "check enablement status", "initialize configuration", and "verify prerequisites" — grounded in a named domain ("RT 2.0 setup ... for parent segments"). Two of the three actions are concrete; "verify prerequisites" is comparatively generic, so it falls at anchor 4 (several specific actions, minor gaps) rather than anchor 5's comprehensive, fully concrete coverage.

4 / 5

Completeness

The "what" is clearly stated (check enablement, initialize configuration, verify prerequisites) but there is no "Use when..." clause or any equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the "what" is concrete and multi-part, not vague.

3 / 5

Trigger Term Quality

Relevant keywords exist ("RT 2.0", "setup", "enablement", "configuration", "parent segments") but common variations and synonyms a user would naturally say are missing — no "real-time", "realtime personalization", "initialize RT", or equivalent phrasing variations. It matches anchor 3 (some relevant keywords, missing common variations) and not anchor 4, which expects good coverage with only a few natural terms absent.

3 / 5

Distinctiveness Conflict Risk

"Initial RT 2.0 setup" plus "parent segments" carves out a clear niche distinct from generic configuration skills, and "Initial" separates it from sibling skills like rt-config-events/rt-config-attributes. However, without trigger phrases it could still overlap with those closely related rt-config-* skills, matching anchor 4 (mostly distinct, minor overlap risk) rather than anchor 5's minimal-conflict clear triggers.

4 / 5

Total

14

/

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.