generate-sitemap - SKILL.md Agent Skill

name: generate-sitemap description: Generate hierarchical site structure and navigation maps. Creates visual representations of information architecture and content relationships. required_roles: scribe: roles/scribe.viewer personas: [information-architect, ux-designer, web-developer]

Generate Sitemap Skill

Generate a hierarchical representation of the site structure and navigation maps. This skill visualizes the information architecture to support user experience design and content organization.

Inputs

PATH - The root directory of the project or site (e.g., "/project")
HIERARCHICAL - (Optional) Boolean, whether to strictly follow directory hierarchy (default: true)
CROSS_REFERENCES - (Optional) Boolean, whether to include cross-links between pages (default: false)
EXPORT_FORMAT - (Optional) Output format: "markdown", "xml", "svg", "mermaid" (default: "mermaid")

Workflow

Step 1: Structure Traversal

Traverse the PATH to understand the directory and file structure.

Build a tree representation of folders and files.
Identify "index" or "home" pages for each section.

Step 2: Relationship Mapping

If CROSS_REFERENCES is true, analyze links within content to identify non-hierarchical connections.

Map internal links between nodes.
Identify "See Also" or related content sections.

Step 3: Visualization Generation

Convert the structural tree into the requested EXPORT_FORMAT.

For Mermaid (Diagram):

Generate a graph TD or Mindmap definition.
Nodes represent pages/sections.
Edges represent hierarchy (parent-child) or links.

For XML (Standard Sitemap):

Generate compliant sitemap.xml format.

Step 4: Output Rendering

Return the generated sitemap code or file.

Required Outputs

A SITEMAP_OUTPUT string containing the sitemap representation in the specified OUTPUT_FORMAT.

Example (Mermaid):

graph TD
    Root[Home] --> Docs[Documentation]
    Root --> Blog[Blog]
    Docs --> API[API Reference]
    Docs --> Guides[User Guides]
    API --> Auth[Authentication]

Quick Reference

Purpose: Visualize and plan information architecture and navigation.
Tools: Compatible with Mermaid.js for visualization.