CtrlK
BlogDocsLog inGet started
Tessl Logo

seo-structure-architect

Analyzes and optimizes content structure including header hierarchy, suggests schema markup, and internal linking opportunities. Creates search-friendly content organization.

48

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

55%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 content is reasonably concise and outlines a sensible analytical workflow with a useful blueprint template, but it stops short of executable guidance and lacks validation checkpoints. Progressive disclosure is undermined by a broken/missing reference file and no real content split.

Suggestions

Make the referenced 'resources/implementation-playbook.md' exist or remove the dangling reference; either provide the file or inline only what is needed.

Add concrete executable artifacts, e.g., a sample JSON-LD schema block and a header-hierarchy validation checklist, instead of descriptive bullets.

Insert validation checkpoints into the workflow (e.g., 'Verify each page has exactly one H1', 'Validate JSON-LD via Schema Markup Validator before delivering').

DimensionReasoningScore

Conciseness

The body is reasonably lean with short bulleted sections and minimal padding; it largely assumes Claude's knowledge of SEO concepts, though a few sections (e.g., 'SEO Guidelines' and 'Siloing Strategy') restate well-known basics that could be trimmed, keeping it just below a 5.

4 / 5

Actionability

It provides a concrete structure-blueprint template and a JSON-LD/schema deliverable list, but most guidance is descriptive ('Suggest internal linking opportunities', 'Recommend appropriate schema types') with no executable commands, code, or specific implementation steps beyond the ASCII outline, matching the 'some concrete guidance but incomplete' anchor.

3 / 5

Workflow Clarity

The numbered 'Approach' lists a sequence (analyze -> evaluate -> identify -> suggest -> recommend -> assess -> format) but has no validation checkpoints and no feedback loops, and the body references the potentially destructive/batch act of restructuring content without verification, capping it at 3.

3 / 5

Progressive Disclosure

There is one in-body reference to 'resources/implementation-playbook.md' for detailed examples, but that directory/file does not exist in the bundle, so the reference is a dead pointer; the rest is a single inlined monolithic document with no real file split, fitting the 'minimal structure / references buried or broken' anchor.

2 / 5

Total

12

/

20

Passed

Description

51%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 conveys a clear 'what' with a few concrete SEO-structure actions but omits any explicit 'when to use' trigger guidance, which caps its completeness. Trigger terms are relevant but lack natural user phrasings and synonyms.

Suggestions

Add an explicit 'Use when...' clause naming concrete triggers, e.g. 'Use when auditing header hierarchy, planning internal links, or adding schema markup to content.'

Include natural user-facing terms and synonyms such as 'H1/H2 tags', 'schema.org', 'SEO structure', and 'content outline'.

Sharpen specificity by naming concrete deliverables like 'JSON-LD schema blocks' and 'header hierarchy blueprints' rather than generic actions.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions ('Analyzes and optimizes content structure', 'suggests schema markup', 'internal linking opportunities', 'Creates search-friendly content organization'), but these are fairly generic and not deeply comprehensive, fitting the score-3 anchor of domain plus a few concrete actions.

3 / 5

Completeness

It clearly answers 'what' (analyzes/optimizes structure, suggests schema, internal linking) but has no 'Use when...' clause or explicit trigger guidance for when to invoke it, capping completeness at 3 per the rubric guideline.

3 / 5

Trigger Term Quality

It contains some relevant keywords ('header hierarchy', 'schema markup', 'internal linking') but lacks the natural phrases and variations a user would actually say (e.g., 'H1 tags', 'SEO structure', 'schema.org'), matching the 'some relevant keywords but missing common variations' anchor.

3 / 5

Distinctiveness Conflict Risk

The SEO content-structure niche ('header hierarchy', 'schema markup', 'internal linking') is fairly distinct from other skills with only minor overlap risk against general SEO or content-writing skills, landing above the midpoint.

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

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