CtrlK
BlogDocsLog inGet started
Tessl Logo

share-buttons

Use when applies to blog posts, news articles, tutorials, and other long-form content. Less relevant for product pages, service pages, or home pages. Use when optimizing content distribution.

49

Quality

53%

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

Quality

Content

71%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 well-organized, token-efficient overview with a clean audit workflow and an exemplary one-level reference structure. Its main weakness is that the single most important executable detail — the platform share URL formats — lives only in the reference, so the Fix section alone leaves Claude unable to complete the task without opening rule.md.

Suggestions

Inline the four platform share URL schemes (X, LinkedIn, Facebook, WhatsApp) — or at least one concrete example anchor tag — into the Fix section so the core task is executable from the body alone.

Remove the duplicated backlink rationale between the intro sentence and the Quick Reference bullet.

State the verification step concretely in the body (e.g. "confirm the rendered anchor href resolves to the platform's share endpoint") instead of the vague "describe how to verify the final page output".

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — short bulleted sections with no padding or explanation of concepts Claude already knows. One instance of duplication keeps it at anchor 4 rather than 5: the intro's "shared articles gain traffic, which can attract backlinks" is repeated almost verbatim as the Quick Reference bullet "Share buttons do not directly affect Google ranking but drive traffic that can result in backlinks".

4 / 5

Actionability

The Fix section gives some concrete specifics ("Use `window.location.href` or the page's canonical URL as the shared link", "Include `og:title` and `og:image`") but the key executable detail is missing: "Add share links constructed with platform share URLs" names the mechanism without ever providing a single share URL format in the body. This is anchor 3 ('some concrete guidance but incomplete; missing key details') — not 4 because Claude cannot construct the share links from the body alone, and not 2 because the Check/Fix guidance goes beyond high-level hints.

3 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review structure gives a clear, coherent sequence for this audit-style skill, and as a simple single-task skill it approaches the simple-skill exception. However, verification is only vaguely gestured at ("describe how to verify the final page output") rather than stated as explicit steps, matching anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'). Not destructive or batch, so no cap applies; not 5 because the verification checkpoint is implicit.

4 / 5

Progressive Disclosure

The body is well under 50 lines, well-organized with clear section headers, and defers implementation detail via a single clearly signaled, one-level-deep pointer — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — which exists on disk and contains exactly that (share URL code examples, platform table, verification steps). This matches anchor 5 and the under-50-line simple-skill pattern.

5 / 5

Total

16

/

20

Passed

Description

36%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 establishes reasonable scope boundaries (long-form content in, product/service/home pages out) but completely omits the skill's purpose — nothing indicates it is about social share buttons. A user asking to "add share buttons" or improve "social sharing" would not naturally trigger this skill, and it risks firing for unrelated content-SEO tasks.

Suggestions

State the 'what' explicitly and lead with it, e.g. "Add privacy-friendly social share buttons (X, LinkedIn, Facebook, WhatsApp) using platform share URLs without third-party scripts."

Include the natural trigger terms users would actually say — "share buttons", "social sharing", "social media buttons" — so the skill is discoverable for its core task.

Fix the ungrammatical opening ("Use when applies to blog posts") to a well-formed third-person trigger clause.

DimensionReasoningScore

Specificity

The description names the domain ("blog posts, news articles, tutorials, and other long-form content") but lists no concrete actions; the only action-like phrase is the generic "optimizing content distribution", and it never states what the skill does (add social share buttons). This matches anchor 2 ('names the domain but actions are minimal or generic') rather than anchor 3, which requires 1-2 concrete named actions.

2 / 5

Completeness

Only the 'when' is present ("Use when applies to blog posts...", "Less relevant for product pages, service pages, or home pages", "Use when optimizing content distribution") with no statement of what the skill does — the exact anchor-2 case ('only when is present without what', cf. "Use when working with documents"). Not anchor 3 because there is no clear 'what' at all, and the opening clause is also ungrammatical ("Use when applies to") which further obscures intent.

2 / 5

Trigger Term Quality

Some natural keywords users would say are present ("blog posts", "news articles", "tutorials", "long-form content"), but the central trigger phrases for this task — "share buttons", "social sharing", "social media" — are entirely absent, matching anchor 3 ('some relevant keywords but missing common variations or synonyms'). Not anchor 4 because the most important synonyms for the actual capability are missing.

3 / 5

Distinctiveness Conflict Risk

The scoping to long-form content and the explicit exclusions ("Less relevant for product pages, service pages, or home pages") make it somewhat specific, but with no sharing-related vocabulary it would trigger for any content-SEO or content-distribution skill covering blog posts — matching anchor 3 ('somewhat specific but could still overlap with similar skills'). Not anchor 4 because the overlap risk with closely related content-optimization skills is more than minor.

3 / 5

Total

10

/

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.