CtrlK
BlogDocsLog inGet started
Tessl Logo

interactive-product-tour

Designing in-product tours, tooltips, and contextual help that teach product capabilities without becoming friction. Trigger logic, tour architecture, contextual placement, completion tracking. Honest about tooltip-spam (visual noise that users develop blindness to), one-and-done (help invisible at the moment of need), and contextual-when-needed (surfaces help at the moment friction occurs) patterns. Triggers on product tour, in-product tooltip, contextual help, walkthrough, feature tour, hint system, in-app guidance, tour platform. Also triggers when feature adoption is low, when users miss key product capabilities, or when an in-product help system is being scoped for the first time.

53

Quality

60%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/interactive-product-tour/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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

This is a strong, well-crafted description that clearly defines a specific domain (in-product tours and contextual help), lists concrete capabilities and patterns, and provides comprehensive trigger guidance covering both keyword-based and scenario-based triggers. The description uses proper third-person voice throughout and avoids vague language or buzzwords.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and concepts: designing in-product tours, tooltips, contextual help, trigger logic, tour architecture, contextual placement, completion tracking. Also names specific patterns (tooltip-spam, one-and-done, contextual-when-needed).

3 / 3

Completeness

Clearly answers both 'what' (designing tours, tooltips, contextual help with trigger logic, architecture, placement, tracking) and 'when' (explicit trigger terms listed, plus situational triggers like low feature adoption and scoping in-product help systems for the first time).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'product tour', 'in-product tooltip', 'contextual help', 'walkthrough', 'feature tour', 'hint system', 'in-app guidance', 'tour platform'. Also includes scenario-based triggers like 'feature adoption is low' and 'users miss key product capabilities'.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche around in-product education and onboarding UX. The specific focus on tours, tooltips, and contextual help patterns with named anti-patterns makes it highly distinguishable from general UX, documentation, or onboarding skills.

3 / 3

Total

12

/

12

Passed

Implementation

20%

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

This skill reads as a well-organized essay on product tour philosophy but fails as an actionable skill for Claude. It is extremely verbose, restating the same core concepts (tooltip-spam, one-and-done, contextual-when-needed) across multiple sections without adding new actionable detail. The complete absence of concrete examples—no sample trigger logic, no tour configuration templates, no state-tracking schemas, no example tour copy—means Claude would understand the theory but have nothing executable to produce.

Suggestions

Add concrete, executable artifacts: a sample trigger logic configuration (e.g., JSON schema for tour triggers), a tour state tracking data model, and an example micro-tour specification with actual copy and placement details.

Cut the content by at least 50%—remove the repeated explanations of tooltip-spam/one-and-done/contextual-when-needed (state once, reference thereafter), remove the 'voice' description paragraph, and remove explanations of concepts Claude already knows (what tooltips are, what power users are).

Add at least one complete worked example: given a specific product scenario (e.g., 'user enters analytics dashboard for the first time'), show the exact tour spec output including trigger conditions, tour content, placement, dismissal rules, and re-trigger logic.

Move the detailed pattern descriptions (placement patterns, dismissal mechanics, failure modes) entirely into the referenced files and keep only a 1-2 line summary in the main SKILL.md to improve progressive disclosure.

DimensionReasoningScore

Conciseness

Extremely verbose for what it teaches. Extensive prose explaining concepts Claude already understands (what tooltip-spam is, what contextual help means, what power users are). The same ideas are restated multiple times across sections (the tooltip-spam vs one-and-done vs contextual-when-needed framing is introduced in the intro, given its own section, repeated in the closing, and referenced throughout). The 'voice' paragraph and audience descriptions are unnecessary padding. This could be cut to 30% of its length without losing actionable content.

1 / 3

Actionability

The skill is entirely conceptual with no concrete, executable guidance. There are no code examples, no specific commands, no templates, no sample tour configurations, no example trigger logic implementations, no JSON schemas for tour state tracking. It describes what to think about but never shows what to do. A user reading this would understand the philosophy but have nothing copy-paste ready to implement.

1 / 3

Workflow Clarity

The 12-consideration framework provides a clear checklist sequence for designing or auditing a tour system, and the sections are logically ordered. However, there are no validation checkpoints, no concrete 'do X then verify Y' steps, and no feedback loops for error recovery. The workflow is more of a conceptual checklist than an actionable process with verification gates.

2 / 3

Progressive Disclosure

The skill references 9 separate reference files with clear descriptions and links, which is good structure. However, since no bundle files are provided, these references are unverifiable. The main SKILL.md itself is a wall of text that could benefit from moving detailed content (like the full failure modes list or the placement patterns) into the referenced files rather than duplicating concepts inline. The overview sections are too long for an overview document.

2 / 3

Total

6

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
rampstackco/claude-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.