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
60%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/interactive-product-tour/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
8e70d03
Table of Contents
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.