Name: site-architecture
Rating: 69.6 (1 reviews)
Author: administrakt0r

site-architecture

Plan or restructure website hierarchy, navigation, URL patterns, breadcrumbs, and internal linking. Use when mapping pages, sections, and site structure, but not for XML sitemap auditing or schema markup.

Quality

85%

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

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

Quality

Content

78%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 highly actionable, well-structured reference that uses progressive disclosure effectively to offload templates. Its main weakness is mild verbosity where it restates basic information-architecture concepts Claude already knows.

Suggestions

Trim elementary IA explanations (e.g., the 3-click rule rationale and "decision paralysis" aside) to assume Claude's competence and tighten token efficiency.

Promote the implicit Before-Planning → design → Output sequence into an explicit numbered workflow with validation checkpoints so the process is unmistakable.

Consolidate the partially overlapping URL-pattern tables (by page type, by site type) to reduce repetition and further respect the token budget.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient reference material (URL pattern tables, mistake lists), but it explains concepts Claude already knows such as the 3-click rule and "more causes decision paralysis," fitting the score-3 anchor of mostly efficient with some unnecessary explanation.	3 / 5
Actionability	It provides directly usable, specific guidance — URL pattern tables, ASCII tree and breadcrumb formats, Mermaid templates, concrete nav rules, and a link-audit checklist — covering common cases, matching the score-5 anchor for actionable instruction.	5 / 5
Workflow Clarity	A clear sequence runs from "Before Planning" context gathering through the five numbered Output Format deliverables, with the Link Audit Checklist acting as a checkpoint; minor validation gaps keep it just below the score-5 anchor.	4 / 5
Progressive Disclosure	The body is a clear overview with three well-signaled one-level-deep references (site-type-templates.md, navigation-patterns.md, mermaid-templates.md), all verified to exist, with detailed templates appropriately split out, matching the score-5 anchor.	5 / 5
	Total	17 / 20 Passed

Description

92%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 concrete, trigger-rich, and explicitly distinguishes itself from adjacent skills with a clear use/non-use boundary. Its only minor gap is slightly thinner synonym coverage in the trigger terms.

Dimension	Reasoning	Score
Specificity	"Plan or restructure website hierarchy, navigation, URL patterns, breadcrumbs, and internal linking" lists multiple concrete actions with comprehensive coverage of the site-architecture domain, matching the score-5 anchor.	5 / 5
Completeness	It explicitly states the "what" (plan/restructure hierarchy, navigation, URL patterns, breadcrumbs, internal linking) and the "when" ("Use when mapping pages, sections, and site structure") with concrete trigger phrases, matching the score-5 anchor.	5 / 5
Trigger Term Quality	Natural terms like "pages," "sections," "site structure," "navigation," "breadcrumbs," and "internal linking" give good coverage a user would say, but a few synonyms are missing, fitting between the 3 and 5 anchors.	4 / 5
Distinctiveness Conflict Risk	The clear site-architecture niche plus the explicit exclusion "but not for XML sitemap auditing or schema markup" minimizes overlap with adjacent skills, matching the score-5 anchor.	5 / 5
	Total	19 / 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/site-architecture/SKILL.md
Commit: 57c135b

Reviewed: 9 days 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.