site-architecturelisted
Install: claude install-skill sitetiller/ai-visibility-skills
# Site architecture
Goal: every important page is reachable through plain links in a few clicks, URLs say where a page sits, and related pages link to each other through a hub. New pages get a home before they are written.
## Steps
1. Crawl from the home page (polite: one request at a time, robots.txt respected):
```bash
npx sitetiller crawl https://example.com --max 200 --json
npx sitetiller links https://example.com --pages 100 --json
```
From `crawl`: each page's `depth` (clicks from the start URL), `deep-page` findings (over 3 clicks), `no-internal-links`, `link-to-redirect`, `broken-internal-link`, and `blockedByRobots`. From `links`: sitemap URLs that no crawled page links to (`orphans`) and weakly linked ones.
2. Map the current structure: group URLs by first folder (`/blog/`, `/tools/`, `/docs/`), count pages per group, and list the hub page of each group. A group without a hub page that links to its members is the first gap.
3. Apply the rules:
- **Links Google can follow:** `<a href="...">` with a real URL. Not buttons with click handlers, not links that only exist after a user action.
- **Descriptive URLs:** words separated by hyphens, readable folders, one URL per piece of content; avoid session IDs and endless parameter combinations.
- **Depth:** keep revenue and key content pages within about three clicks of the home page (a working rule; Google publishes no number). Hubs and breadcrumbs are how large sites do this.
- **Breadcrumbs:*