site-architecture

When the user wants to audit, redesign, or plan their website's structure, URL hierarchy, navigation design, or internal linking strategy. Use when the user mentions 'site architecture,' 'URL structure,' 'internal links,' 'site navigation,' 'breadcrumbs,' 'topic clusters,' 'hub pages,' 'orphan pages,' 'silo structure,' 'information architecture,' or 'website reorganization.' Also use when someone has SEO problems and the root cause is structural (not content or schema). NOT for content strategy decisions about what to write (use content-strategy) or for schema markup (use schema-markup).

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

75%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, actionable body with concrete commands, reference tables, and real bundle files linked one level deep. Main weaknesses are minor editorializing, no explicit validation feedback loops in the workflows, and more inlined reference detail than ideal.

Suggestions

Trim motivational/editorializing prose (e.g., 'Most sites optimize for neither,' 'the most underused SEO lever') to tighten conciseness toward a 5.

Add an explicit validation checkpoint to Mode 1 (e.g., 'Verify the sitemap_analyzer output flags orphans/duplicates before prioritizing fixes') to strengthen workflow_clarity feedback loops.

Move the large Common Architecture Mistakes and URL Construction Rules tables into a reference file, leaving a concise summary in SKILL.md, to improve progressive_disclosure toward a 5.

Dimension	Reasoning	Score
Conciseness	Mostly lean with dense, useful tables and specific examples, but contains minor editorializing that could be trimmed ('Navigation serves two masters… Most sites optimize for neither,' 'Internal links are the most underused SEO lever'). Not a 3 because it avoids explaining basic concepts Claude already knows.	4 / 5
Actionability	Concrete, executable guidance throughout — 'Run scripts/sitemap_analyzer.py,' specific do/don't URL tables, anchor-text type table — with minor gaps (no copy-paste redirect implementation, deferred to the playbook reference). Not a 5 because it is strategy guidance rather than fully copy-paste-ready code.	4 / 5
Workflow Clarity	Three modes each present a clear, concrete numbered sequence with defined deliverables; review steps serve as implicit checkpoints. Not a 3 because sequences are explicit and well-defined; not a 5 because there are no explicit validate→fix→retry feedback loops, though the skill is advisory/read-only rather than destructive.	4 / 5
Progressive Disclosure	Clear section structure with well-signaled one-level-deep references to real files (references/url-design-guide.md, references/internal-linking-playbook.md) and a real script. Not a 5 because substantial reference-style detail (large URL/navigation/mistakes tables) remains inlined in SKILL.md rather than being split into reference files.	4 / 5
	Total	16 / 20 Passed

Description

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

An exemplary description: concrete actions, exhaustive natural trigger terms, explicit what-and-when guidance, and clear boundary statements that distinguish it from sibling skills. Nothing vague or padded.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'audit, redesign, or plan their website's structure, URL hierarchy, navigation design, or internal linking strategy' — with comprehensive coverage of the skill's scope, matching the anchor for several specific concrete actions.	5 / 5
Completeness	Explicitly answers both what (audit/redesign/plan structure, URL hierarchy, navigation, internal linking) and when ('Use when the user mentions…' plus 'Also use when someone has SEO problems and the root cause is structural'), with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural-term coverage including synonyms and variations — 'site architecture,' 'URL structure,' 'internal links,' 'breadcrumbs,' 'topic clusters,' 'hub pages,' 'orphan pages,' 'silo structure,' 'information architecture,' 'website reorganization' — the phrases a user would naturally say.	5 / 5
Distinctiveness Conflict Risk	Clear niche with explicit NOT-for boundaries — 'NOT for content strategy decisions about what to write (use content-strategy) or for schema markup (use schema-markup)' — minimizing conflict risk with adjacent skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: alirezarezvani/claude-skills
Path: marketing-skill/skills/site-architecture/SKILL.md
Commit: 19392f7

Reviewed: ~1 hour 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.