generate-sitemap

Generate hierarchical site structure and navigation maps. Creates visual representations of information architecture and content relationships.

Quality

41%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/generate-sitemap/SKILL.md

Quality

Discovery

32%

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 adequately conveys the domain (site structure and navigation visualization) but lacks explicit trigger guidance for when Claude should select this skill. It uses appropriate third-person voice but would benefit from more specific actions and natural user keywords like 'sitemap' or 'IA diagram'.

Suggestions

Add a 'Use when...' clause with trigger terms like 'sitemap', 'site map', 'navigation structure', 'IA diagram', 'page hierarchy'

Include common file formats or outputs (e.g., 'generates XML sitemaps, visual tree diagrams, navigation flowcharts')

Add natural user phrases like 'website structure', 'site tree', 'page organization' to improve trigger term coverage

Dimension	Reasoning	Score
Specificity	Names the domain (site structure, navigation maps) and some actions (generate, creates visual representations), but lacks comprehensive specific actions like 'create sitemaps, diagram page hierarchies, export navigation flows'.	2 / 3
Completeness	Describes what it does but completely lacks a 'Use when...' clause or any explicit trigger guidance. Per rubric guidelines, missing explicit trigger guidance caps completeness at 2, and this has no trigger guidance at all.	1 / 3
Trigger Term Quality	Includes some relevant terms like 'site structure', 'navigation maps', 'information architecture', but misses common user terms like 'sitemap', 'IA diagram', 'website map', 'page hierarchy', or 'site tree'.	2 / 3
Distinctiveness Conflict Risk	Somewhat specific to site architecture visualization, but 'visual representations' and 'content relationships' could overlap with diagramming tools, documentation skills, or general visualization skills.	2 / 3
	Total	7 / 12 Passed

Implementation

50%

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

This skill provides a reasonable conceptual framework for sitemap generation with clear inputs and workflow steps, but lacks the concrete, executable guidance needed for high actionability. The workflow describes what to do without providing actual code implementations, and validation/error handling steps are missing for what could be a complex file traversal operation.

Suggestions

Add executable code snippets for directory traversal and tree building (e.g., Python using os.walk or pathlib)

Include validation steps after structure traversal (e.g., 'Verify all index files exist') and after generation (e.g., 'Validate XML against sitemap schema')

Provide concrete examples for each export format, not just Mermaid - especially XML sitemap format which has specific schema requirements

Add error handling guidance for edge cases like circular symlinks, permission errors, or malformed internal links

Dimension	Reasoning	Score
Conciseness	The skill is reasonably efficient but includes some unnecessary explanation (e.g., 'This skill visualizes the information architecture to support user experience design'). The workflow steps could be more compact.	2 / 3
Actionability	Provides a workflow structure and one Mermaid example, but lacks executable code for traversal, link analysis, or format conversion. Steps describe what to do conceptually rather than providing copy-paste implementations.	2 / 3
Workflow Clarity	Steps are listed in sequence but lack validation checkpoints. No guidance on error handling, verifying the generated sitemap is correct, or handling edge cases like broken links or circular references.	2 / 3
Progressive Disclosure	Content is organized with clear sections, but everything is inline in one file. For a skill covering multiple export formats (XML, SVG, Mermaid, Markdown), examples for each format could be split into referenced files.	2 / 3
	Total	8 / 12 Passed

Validation

90%

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 — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: dandye/ai-runbooks
Commit: 4d132c7

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