CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rt-setup-personalization

Complete workflow to set up RT 2.0 personalization from scratch - validates parent segment RT status, discovers event tables and attributes, configures RT infrastructure (events, attributes, ID stitching), creates personalization service, and deploys the personalization entity with payload. Use when user wants to "create realtime setup and build personalization" or "set up RT personalization end-to-end". Includes automatic validation using rt-personalization-validation skill to prevent common API errors.

Quality

85%

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

77%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 delivers a well-sequenced, highly actionable orchestrator with strong validation and error-recovery structure. Its main defects are delivery-level: all five referenced step files are missing from the bundle (breaking the progressive-disclosure structure), plus a malformed code fence and a 9-vs-10 step count inconsistency.

Suggestions

Ship the five referenced step files (steps/01-02-validate-discovery.md, steps/03-06-data-exploration.md, steps/07-rt-config.md, steps/08-09-personalization.md, steps/10-verification.md) in the bundle, or inline their essential detail and drop the links — currently every 'See ... for detailed implementation' reference dead-ends.

Fix the malformed code fence in section 7b: the ```bash block containing `tdx ps desc <ps_id> --json | jq '.master'` is never closed before the next fence opens, breaking rendering of the extLookupKey commands.

Correct the 'Complete 9-step workflow' header to 10 steps, and de-duplicate the RT-status check (Steps 1, 3, 7, and 10 all repeat it) plus the four-fold repetition of the Step 9c validation mandate to tighten conciseness.

DimensionReasoningScore

Conciseness

Mostly efficient — commands, expected outputs, and checkpoints with no explanations of concepts Claude already knows — but there is trimmable repetition: the RT-status check appears in Steps 1, 3, 7, and 10, the Step 9c validation mandate is restated four times, and the closing Summary section re-lists checkpoints already covered. Not 5 because of this redundancy; not 3 because none of it is concept-teaching padding.

4 / 5

Actionability

Concrete, mostly executable guidance throughout — full tdx/curl commands with jq filters, all three RT attribute payload types, a wait-for-status loop, and verification commands with expected outputs. Minor gaps keep it below the copy-paste-ready top anchor: the "Complete 9-step workflow" header mislabels the 10 steps actually listed, and the 7b code block is malformed (an unclosed ```bash fence before the next one opens), which breaks rendering of the extLookupKey commands.

4 / 5

Workflow Clarity

A clear 10-step sequence with sub-steps (9a–9d), explicit checkpoints after every phase, a mandatory validation gate at Step 9c, a wait-loop feedback cycle for RT status, an error-handling section with remediation guidance, and a final verification checklist with expected values — matching the top anchor (explicit validation steps, feedback loops, and checklists) rather than the 'most checkpoints, minor gaps' anchor.

5 / 5

Progressive Disclosure

The design is right — SKILL.md as an overview with clearly signaled one-level-deep references to steps/01-02-validate-discovery.md, steps/03-06-data-exploration.md, steps/07-rt-config.md, steps/08-09-personalization.md, and steps/10-verification.md — but none of these files exist in the bundle (no steps/, references/, scripts/, or assets/ directories are present), so every 'See ... for detailed implementation' link dead-ends. Not 4 because missing referenced files are more than a minor organization gap; not 2 because references are prominently signaled and each section still carries a usable quick summary inline.

3 / 5

Total

16

/

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: it comprehensively enumerates the workflow's concrete actions, includes an explicit 'Use when' clause with natural quoted trigger phrases, and stays in third-person imperative voice. The only gaps are missing synonym variations (e.g., "real-time", "Treasure Data") and minor overlap risk with the sibling rt-setup-triggers skill.

DimensionReasoningScore

Specificity

The description enumerates six concrete actions — "validates parent segment RT status, discovers event tables and attributes, configures RT infrastructure (events, attributes, ID stitching), creates personalization service, and deploys the personalization entity with payload" — covering every phase of the workflow comprehensively, matching the top anchor rather than the 'several specific actions with minor gaps' anchor below.

5 / 5

Completeness

Explicitly answers both questions: a clear, comprehensive 'what' (the full action enumeration) and a concrete 'when' — "Use when user wants to 'create realtime setup and build personalization' or 'set up RT personalization end-to-end'" — with quotable trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

Good natural trigger phrases ("create realtime setup and build personalization", "set up RT personalization end-to-end") plus solid domain keywords (RT 2.0, personalization, parent segment, event tables, ID stitching), but common synonyms are missing — no "real-time" spelled out, no "Treasure Data"/"TD", no "personalization API" variations. Not 5 because synonym/variation coverage is incomplete; not 3 because multiple natural phrases users would actually say are present.

4 / 5

Distinctiveness Conflict Risk

Clear niche (RT 2.0 personalization setup) with personalization-specific triggers, but the sibling skill rt-setup-triggers shares the same RT infrastructure domain, and the "create realtime setup" portion of the first trigger phrase could plausibly match a triggers request — minor overlap risk with a closely related skill, fitting anchor 4 rather than the minimal-conflict anchor 5.

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

Warning

Total

15

/

16

Passed

Repository

treasure-data/td-skills

Path

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