# Generate Sitemap

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

- Skill: `dandye/generate-sitemap` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dandye/generate-sitemap`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dandye/generate-sitemap/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dandye (https://skillmd.com/u/dandye)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/dandye/generate-sitemap

---


# 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):**
```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.