internal-links

Use when auditing a site's internal link structure, identifying pages that need more incoming links, generating contextual linking opportunities between related content, or reviewing a CMS template's internal linking patterns.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/internal-links/SKILL.md

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable overview with good progressive disclosure to a real reference file, weakened by redundant PageRank exposition Claude already knows and by the absence of validation checkpoints in what amounts to a batch linking workflow.

Suggestions

Trim the '## Explain' section and the PageRank restatement in the intro to concept Claude already knows, keeping only the PageRank-as-link-signal point that drives the actions.

Add a validation/recheck step to the workflow (e.g., 'After adding links, re-run the crawl and confirm previously orphaned pages now have in-degree >= 2') to close the feedback loop for this batch operation.

Move the Code Review build instructions (in-degree computation, anchor-text flagging) into `references/rule.md` with executable examples, keeping the body as overview.

Dimension	Reasoning	Score
Conciseness	The body is reasonably compact and mostly actionable, but the intro and '## Explain' sections re-teach PageRank ('PageRank, Google's foundational ranking algorithm, flows from page to page...') — a concept Claude already knows — and overlap with the Quick Reference, fitting the score-2 anchor of mostly efficient with some unnecessary explanation.	2 / 3
Actionability	Concrete, copy-ready guidance abounds for an instruction-only skill: numbered Fix steps, specific thresholds ('in-degree < 2', 'top 10–20 most important pages'), and a worked anchor-text swap ('instead of "click here", use "our guide to CSS Grid"'); per the scoring note, absence of code is not penalized when guidance is this actionable.	3 / 3
Workflow Clarity	Check and Fix are sequenced with numbered steps, but there are no validation checkpoints or feedback loops (e.g., re-crawl to confirm orphan pages gained links), and site-wide link additions are effectively batch operations — matching the score-2 anchor of steps present but checkpoints missing.	2 / 3
Progressive Disclosure	The body is cleanly sectioned (Quick Reference, Check, Fix, Explain, Code Review) and ends with a clearly signaled, verified one-level-deep reference — 'see `references/rule.md`' (file confirmed present) — matching the score-3 anchor.	3 / 3
	Total	10 / 12 Passed

Description

82%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A trigger-rich, specific description with strong natural-language keywords and a clear niche, but it leads entirely with 'when' clauses and omits an explicit statement of what the skill does, capping completeness at 2.

Suggestions

Lead with a brief capability statement (e.g., 'Adds and audits contextual internal links to strengthen PageRank flow to key pages.') before the 'Use when...' triggers so both 'what' and 'when' are explicit.

Add common user phrasings like 'internal links', 'orphan pages', or 'linking related articles' to broaden trigger coverage.

Dimension	Reasoning	Score
Specificity	The description lists multiple concrete actions — 'auditing a site's internal link structure, identifying pages that need more incoming links, generating contextual linking opportunities... or reviewing a CMS template's internal linking patterns' — matching the score-3 anchor of several specific concrete actions.	3 / 3
Completeness	It opens with 'Use when...' and enumerates four explicit triggers, so 'when' is strong, but there is no standalone 'what does this do' statement — the capability is only implied by the trigger phrases, mirroring the score-2 anchor where one half is explicit and the other only implied.	2 / 3
Trigger Term Quality	Natural terms a user would say ('internal link structure', 'pages that need more incoming links', 'contextual linking opportunities', 'CMS template's internal linking patterns') give good coverage, matching the score-3 anchor.	3 / 3
Distinctiveness Conflict Risk	Internal-link auditing and contextual linking is a clearly bounded SEO niche with distinct triggers, unlikely to collide with other skills, matching the score-3 anchor.	3 / 3
	Total	11 / 12 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning

	Total	15 / 16 Passed

Repository: thedaviddias/Front-End-Checklist
Path: skills/internal-links/SKILL.md
Commit: 48405aa

Reviewed: about 10 hours ago

Table of Contents

Discovery Implementation Validation

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.