CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

affiliate-disclosure

Use when auditing metadata, crawlability, structured data, or indexability related to Provide clear affiliate disclosures. Verify the rendered HTML and HTTP response rather than relying only on source files.

59

Quality

74%

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/affiliate-disclosure/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.

A well-structured, lean rule skill with a coherent Check→Fix sequence and exemplary progressive disclosure to a real, one-level reference file. The main weakness is actionability in the body itself: no example disclosure statement or concrete detection method is surfaced, leaving the reader to open the reference for the actual artifact.

Suggestions

Inline one copy-paste-ready example disclosure statement (e.g. the "Disclaimer: This post contains affiliate links..." text from references/rule.md) in the Fix section so the body is actionable on its own.

Add one concrete Check technique, such as a grep pattern or selector for affiliate link hrefs (e.g. `?aff=`, `/ref/`, `amzn.to`) and a note to inspect the rendered DOM, not the source template.

Add a brief re-verify step after Fix (re-check the rendered page to confirm the disclosure appears before the first affiliate link) to close the validation loop.

DimensionReasoningScore

Conciseness

The body is lean — short Quick Reference bullets and one-to-two-sentence Check/Fix/Explain/Code Review sections with no tutorial padding about concepts Claude already knows. Not 5 because the opening sentence ("required by law (e.g., FTC guidelines)... user trust") and the "Explain" section ("legal and ethical importance... user trust and SEO") restate the same rationale twice, a minor trim.

4 / 5

Actionability

Some concrete guidance exists ("Place the disclosure at the top of the page, before any affiliate links appear", "Use simple, unambiguous language"), but the body never shows an example disclosure statement, example markup, or a method for locating affiliate links (selector, grep, crawl) — the actual example is deferred to references/rule.md. Fits 'some concrete guidance but incomplete; missing key details'; not 4 because nothing in the body itself is copy-paste ready, and not 2 because the placement and wording directives are specific.

3 / 5

Workflow Clarity

A coherent simple-skill sequence is present: Quick Reference → Check (verify pages have a visible disclosure before links) → Fix (add a standardized statement) → Explain → Code Review (flag routes/templates and verify final output). Not 5 because there is no re-verification checkpoint after Fix in the body (the reference's "re-crawl after deployment" loop is not surfaced); not 3 because each step is unambiguous and correctly ordered for a single-purpose skill.

4 / 5

Progressive Disclosure

The body is a concise overview that appropriately defers implementation detail via one clearly signaled, one-level-deep reference: "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and that file exists and contains the code example, rationale, exceptions, and verification steps, with no further nesting. Matches the clear-overview anchor exactly.

5 / 5

Total

16

/

20

Passed

Description

66%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 an explicit 'Use when' trigger and reasonable SEO-audit keywords, but the capability statement is thin (one audit verb plus a verification method) and the template-stitched phrase "related to Provide clear affiliate disclosures" reads awkwardly. The broad SEO-audit trigger creates overlap risk with sibling rule skills while the niche term itself is distinctive.

Suggestions

Replace the spliced rule title with a natural capability list, e.g. "Audits pages for clear, conspicuous affiliate and sponsored-link disclosures. Flags missing or hidden disclosures and verifies the rendered HTML and HTTP response rather than only source files."

Add trigger synonyms users would naturally say — "sponsored links", "paid links", "FTC disclosure", "hidden ads" — to improve both trigger coverage and distinctiveness from sibling SEO skills.

Narrow the 'Use when' clause to disclosure-specific triggers (e.g. "Use when auditing affiliate or sponsored content disclosures") so it does not fire for every metadata/crawlability rule.

DimensionReasoningScore

Specificity

Names the domain (SEO auditing of affiliate disclosures) and 1-2 concrete actions — "auditing metadata, crawlability, structured data, or indexability" and "Verify the rendered HTML and HTTP response" — but these are audit targets around a single verb, not a list of several distinct actions (no fixing, flagging, or reporting capabilities). Fits the 'names domain and 1-2 concrete actions' anchor; not 4 because coverage of capabilities is not broader, and not 2 because the actions are more concrete than 'Processes PDF files'.

3 / 5

Completeness

Both parts are present: an explicit trigger ("Use when auditing metadata, crawlability, structured data, or indexability related to...") and a what (audit/verify behavior: "Verify the rendered HTML and HTTP response rather than relying only on source files"). Not 5 because the 'what' states a method rather than a crisp capability list, and the grafted rule-title phrase "related to Provide clear affiliate disclosures" muddies both parts; not 3 because the 'when' clause is explicit, not merely implied.

4 / 5

Trigger Term Quality

Good keyword coverage: "auditing", "metadata", "crawlability", "structured data", "indexability", "affiliate disclosures", "rendered HTML", "HTTP response" — natural terms an SEO reviewer would say. Not 5 because common synonyms are missing ("sponsored links/content", "paid links", "FTC disclosure", "hidden ads"); not 3 because coverage within the niche goes beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

"affiliate disclosures" is a niche term, but the trigger clause "auditing metadata, crawlability, structured data, or indexability" is a generic SEO-audit trigger that would equally fire for sibling SEO rule skills (meta descriptions, robots.txt, structured data rules). Somewhat specific yet with real overlap risk against closely related skills; not 4 because the shared boilerplate trigger would collide within an SEO skill family, not merely with one adjacent skill.

3 / 5

Total

14

/

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

Path

skills/affiliate-disclosure/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.