CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

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

The body is a concise, well-structured overview with a proper one-level-deep reference split and a coherent Check/Fix/Explain flow. Its main weakness is actionability: the body's own guidance stays high-level, leaving the example disclosure copy and link-detection specifics entirely to references/rule.md, and post-fix re-verification is implicit rather than an explicit step.

Suggestions

Inline a one-line example disclosure statement (or the short HTML snippet from references/rule.md) under Fix so the step is copy-paste ready without opening the reference.

Add a concrete detection hint to Check, e.g. grep templates/routes for known affiliate domains or rel="sponsored"/utm-tagged links, so locating affiliate links is executable rather than assumed.

Make post-fix validation explicit: re-render the affected page and confirm the disclosure appears before the first affiliate link (the re-crawl guidance currently buried in references/rule.md).

DimensionReasoningScore

Conciseness

The body is a lean ~40 lines of task-oriented sections with only minor over-explanation — the motivational opener "Clear disclosures are required by law (e.g., FTC guidelines) and are essential for maintaining user trust" and the overlap between the Quick Reference bullets and the Fix section. It is not a 5 because those two spots could be trimmed, and not a 3 because padding is limited to a sentence or two of broadly-known context.

4 / 5

Actionability

"Place the disclosure at the top of the page, before any affiliate links appear" and "Add a standardized disclosure statement at the beginning of your content or near affiliate links" are concrete, but the body never shows example disclosure wording, gives no method for locating affiliate links, and offers only high-level direction like "Use simple, unambiguous language to explain the financial relationship" — matching the anchor for some concrete guidance with key details missing. It is not a 4 because the copy-paste-ready material (the HTML example) lives only in the reference file, and not a 2 because the placement and fix instructions are specific.

3 / 5

Workflow Clarity

The Check → Fix → Explain sections form a coherent sequence and the Check section ("Verify that all pages containing affiliate links or sponsored content have a clear, visible disclosure before the links appear") doubles as the validation checkpoint, so most checkpoints are present. It is not a 5 because there is no explicit post-fix re-verification loop in the body (re-crawl guidance sits in references/rule.md), and not a 3 because the sequence is clear and each phase is well defined.

4 / 5

Progressive Disclosure

The body is a clean overview with 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, holds the code example and detail, and points no further. This matches the anchor for a clear overview with well-signaled one-level references and easy navigation; no structural gaps justify a 4.

5 / 5

Total

16

/

20

Passed

Description

58%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 one concrete verification action, but it is built from template boilerplate: the generic metadata/crawlability/indexability phrasing buries the actual affiliate-disclosure purpose, garbles the grammar, and raises conflict risk with sibling SEO audit skills. Natural trigger synonyms for this topic (affiliate links, sponsored content, FTC) are largely absent.

Suggestions

Rewrite the description around the rule's real purpose, e.g. "Audit pages for clear, visible affiliate and sponsored-link disclosures (FTC-style) and add standardized disclosure statements. Use when checking affiliate links, sponsored content, or hidden-ad compliance on rendered pages."

Add natural trigger synonyms such as "affiliate links", "sponsored content", "FTC disclosure", and "hidden ads" so the skill matches how users actually phrase the need.

Drop the generic "metadata, crawlability, structured data, or indexability" boilerplate — it overlaps sibling SEO rule skills and makes the description read as an indexability audit rather than a disclosure check.

DimensionReasoningScore

Specificity

"Verify the rendered HTML and HTTP response rather than relying only on source files" is one concrete action, and "auditing metadata, crawlability, structured data, or indexability" names the domain, but the audit verbs are generic and coverage of the skill's actual check/fix scope is incomplete — matching the anchor for domain plus 1-2 concrete actions. It is not a 4 because no list of several specific actions is given, and not a 2 because the verification action is genuinely concrete.

3 / 5

Completeness

Both parts are explicitly present: "Use when auditing ... related to ... affiliate disclosures" supplies the when, and "Verify the rendered HTML and HTTP response rather than relying only on source files" supplies a what. It is not a 5 because the "what" reads as a verification method rather than the skill's full check/fix capability and the when-clause is garbled template phrasing ("related to Provide clear affiliate disclosures"); not a 3 because both what and when are stated, not merely implied.

4 / 5

Trigger Term Quality

"affiliate disclosures" is the key natural term and is present, but common variations users would say — "affiliate links", "sponsored content", "FTC disclosure" — are missing, while "metadata, crawlability, structured data, or indexability" is generic SEO boilerplate rather than natural phrasing for this rule. It is not a 4 because synonym coverage is thin, and not a 2 because the core trigger term is relevant and included.

3 / 5

Distinctiveness Conflict Risk

"affiliate disclosures" carves out a niche, but "metadata, crawlability, structured data, or indexability" is template language likely shared verbatim across sibling SEO rule skills, creating real overlap risk — the anchor for somewhat specific but still overlapping. It is not a 4 because the boilerplate dilutes the distinct trigger, and not a 2 because the disclosure term does distinguish it from unrelated skills.

3 / 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.