CtrlK
BlogDocsLog inGet started
Tessl Logo

website-search

Use when applies to sites with internal site search functionality. Use when optimizing branded search result appearance or adding structured data for the first time.

56

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 ./skills/website-search/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 is a lean, well-structured overview: concrete check/fix guidance with exact property names, a clear validation-oriented Check step, and a properly signaled one-level-deep reference that exists. The main gaps are the absence of an inline JSON-LD snippet and no post-fix re-validation step.

DimensionReasoningScore

Conciseness

The body is lean (~45 lines) with purposeful sections and no padding explaining concepts Claude already knows; the Quick Reference bullets deliver rule-specific facts (e.g., 'the schema is a signal, not a guarantee'). Not level 5 because the intro sentence about 'reducing friction for brand-aware users' is trimmable rationale and the 'query-input' format is repeated between Quick Reference and Fix; not level 3 because there is no noticeably unnecessary explanation.

4 / 5

Actionability

The Fix section gives concrete, field-level instruction — 'Set potentialAction with SearchAction, target pointing to your search results URL with {search_term_string} placeholder, and query-input as required name=search_term_string' — enough to construct the markup without the reference. Not level 5 because there is no inline copy-paste JSON-LD example in the body (it is delegated to references/rule.md); not level 3 because the guidance names exact properties and values rather than being pseudocode or missing key details.

4 / 5

Workflow Clarity

A clear Check-then-Fix sequence: Check specifies exactly what to verify ('a <script type=application/ld+json> block with "@type": "WebSite" and a potentialAction of type SearchAction', 'Verify target is a valid search URL template'), and Fix follows with the remedy. Not level 5 because there is no explicit re-validation loop after applying the fix (the Check step is not repeated post-Fix); not level 3 because the verification checkpoint is explicit and the sequence is unambiguous for this simple skill.

4 / 5

Progressive Disclosure

The body is a concise overview with well-organized sections and a single, clearly signaled, one-level-deep reference — 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — and that file exists in the bundle. Content is appropriately split (implementation detail out, summary in), matching the top anchor for this short skill.

5 / 5

Total

17

/

20

Passed

Description

52%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 has strong explicit trigger guidance and a distinct niche, but it is entirely trigger-focused: it never states what the skill does, and the opening clause is ungrammatical ('Use when applies to sites'). Keyword coverage is good though missing the most common synonyms for this feature.

Suggestions

Add a leading third-person capability statement, e.g., 'Adds WebSite structured data (JSON-LD) with a SearchAction to enable the Sitelinks Searchbox in Google branded search results.' before the 'Use when' clauses.

Fix the ungrammatical opening clause 'Use when applies to sites with internal site search functionality' to something like 'Use when the site has internal search functionality'.

Include the natural trigger terms users actually say for this feature: 'sitelinks searchbox', 'WebSite schema', 'JSON-LD', 'search box in Google results'.

DimensionReasoningScore

Specificity

The description names the domain ("internal site search functionality", "branded search result appearance", "adding structured data") and implies 1-2 concrete actions, matching the anchor for naming a domain with limited actions. It is not level 4 because no distinct capability statement lists several actions, and not level 2 because the actions referenced (adding structured data, optimizing branded search appearance) are specific rather than generic — though the garbled opening clause 'Use when applies to sites' weakens clarity.

3 / 5

Completeness

Both clauses are 'Use when' triggers; the description never states what the skill does (e.g., 'Adds WebSite SearchAction JSON-LD schema...'). This matches the anchor-2 pattern 'only when is present without what' (example: 'Use when working with documents'). Per the guideline to score only what is explicitly stated, the what cannot be inferred, so it cannot reach level 3-4 despite the strong explicit when-clauses.

2 / 5

Trigger Term Quality

Good keyword coverage: 'internal site search functionality', 'branded search result appearance', 'structured data' are natural phrases a user might say. Not level 5 because common synonyms users would actually use — 'sitelinks searchbox', 'WebSite schema', 'JSON-LD', 'search box in Google results' — are absent; not level 3 because the present terms are varied and reasonably natural rather than only technical jargon.

4 / 5

Distinctiveness Conflict Risk

The triggers are fairly niche (site search functionality, branded search result appearance, structured data for the first time), giving mostly distinct activation. Not level 5 because 'structured data' and 'adding structured data for the first time' overlap with sibling SEO/structured-data skills; not level 3 because the site-search and branded-result qualifiers keep overlap minor.

4 / 5

Total

13

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.