Name: seo-fundamentals
Rating: 44 (1 reviews)
Author: administrakt0r

seo-fundamentals

Core principles of SEO including E-E-A-T, Core Web Vitals, technical foundations, content quality, and how modern search engines evaluate pages.

Quality

45%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/seo-fundamentals/SKILL.md

The canonical home for this skill is seo-fundamentals in administrakt0r/AI-Agents-Safe-Coding-Skills

Quality

Content

42%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-structured, mostly concise conceptual reference for SEO fundamentals, but it offers no executable guidance, has no real workflow with checkpoints, and fails to link the one bundled script, leaving its practical actionability and progressive disclosure underdeveloped.

Suggestions

Reference and invoke the bundled script in the body (e.g., 'Run `python scripts/seo_checker.py <project>` to audit a page') so the actionable asset is discoverable.

Replace generic boilerplate 'When to Use' with concrete triggers and a short worked example or command sequence that demonstrates applying the principles.

Trim the basic-definitional tables (sitemaps, robots.txt, semantic HTML) that restate knowledge Claude already has to improve token efficiency.

Dimension	Reasoning	Score
Conciseness	The body is table-driven and reasonably compact, but several tables restate basics Claude already knows (XML sitemaps, robots.txt, semantic HTML, title tags), so it is 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than fully lean.	3 / 5
Actionability	The body is purely conceptual — principles and factor tables with no executable code, commands, or specific steps — and the actionable bundle script seo_checker.py is never surfaced, matching 'minimal concrete guidance; high-level hints but missing the specific steps to execute'.	2 / 5
Workflow Clarity	Content is organized into a clear numbered sequence of eight topical sections, but there is no multi-step workflow with validation checkpoints, and the 'When to Use' line is generic boilerplate, so it sits at 'steps listed but validation gaps; sequence present but checkpoints missing'.	3 / 5
Progressive Disclosure	Section headers provide good structure, but the bundled scripts/seo_checker.py is an orphaned asset never referenced from the body and all content is inline, fitting 'some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline'.	3 / 5
	Total	11 / 20 Passed

Description

48%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 is third-person and clearly scoped to SEO fundamentals with decent keyword presence, but it reads as a topic catalog rather than an action statement and omits any 'Use when' trigger guidance, capping completeness and specificity.

Suggestions

Lead with concrete verbs/actions (e.g., 'Audits, explains, and advises on SEO fundamentals...') to raise specificity above a topic list.

Add an explicit trigger clause such as 'Use when the user asks about SEO, search rankings, Core Web Vitals, E-E-A-T, or page optimization.'

Include natural synonyms and file/extension terms users actually say (e.g., 'on-page SEO', 'meta tags', 'structured data') to broaden trigger coverage.

Dimension	Reasoning	Score
Specificity	The description names the SEO domain and enumerates topic areas ('E-E-A-T, Core Web Vitals, technical foundations, content quality') but lists no concrete actions or verbs, fitting the 'names the domain but actions are minimal or generic' anchor rather than the score-3 anchor which requires 1-2 concrete actions.	2 / 5
Completeness	It clearly states 'what' ('Core principles of SEO including ... how modern search engines evaluate pages') but provides no 'Use when...' clause or equivalent trigger guidance, so per the guideline a missing when-clause caps completeness at 3.	3 / 5
Trigger Term Quality	'SEO' is a natural term users would say, and 'E-E-A-T' / 'Core Web Vitals' are domain-relevant, but common variations or synonyms are absent and there is no trigger phrase, matching 'some relevant keywords but missing common variations or synonyms'.	3 / 5
Distinctiveness Conflict Risk	'Core principles of SEO' is a recognizable niche with distinct triggers and only minor overlap risk against adjacent marketing/content skills, fitting 'mostly distinct; minor overlap risk with closely related skills'; not a 5 because the phrasing is still fairly broad.	4 / 5
	Total	12 / 20 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
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: plugins/AI-Agents-Safe-Coding-Skills-claude/skills/seo-fundamentals/SKILL.md
Commit: 57c135b

Reviewed: 23 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.