---
name: maintenance-orchestrator
description: The master workflow that orchestrates all site maintenance skills (SSR, Schema/AEO, Indexing, Sitemap, PageSpeed) into a single, comprehensive audit process.
license: Complete terms in LICENSE.txt
---

# Global Maintenance Orchestrator Skill

This skill serves as the master control for the entire site maintenance suite. It defines the order of operations for running a comprehensive site audit using the specialized skills in this repository.

## The Global Maintenance Workflow

When requested to perform a full site maintenance audit, execute the following steps in order:

### Phase 1: Sitemap Validation
**Goal:** Ensure the foundation of discovery is solid.
**Action:** Run the `sitemap-validation` skill script against the site's `sitemap.xml`.
**Why First:** If the sitemap is broken or contains unclean URLs, search engines won't discover the pages we need to audit.

### Phase 2: Page Indexing Health Check
**Goal:** Verify that critical pages are not blocked from indexing.
**Action:** Run the `page-indexing-health` skill script against key URLs from the sitemap.
**Why Second:** There is no point optimizing a page for speed or AEO if it is blocked by a `noindex` tag or `robots.txt`.

### Phase 3: SSR Verification
**Goal:** Ensure content is accessible to all bots and LLMs.
**Action:** Run the `ssr-verification` skill script against key URLs.
**Why Third:** If the page is a blank CSR shell, the subsequent Schema and AEO checks will fail because the content isn't in the raw HTML.

### Phase 4: Schema.org, Technical SEO & AEO
**Goal:** Maximize visibility in traditional and AI search engines.
**Action:** Run the `schema-seo-aeo` skill script against key URLs.
**Why Fourth:** Now that we know the page is indexable and SSR'd, we verify that the entity graph and technical tags are correctly implemented.

### Phase 5: PageSpeed 95+ Audit
**Goal:** Ensure the user experience meets Google's Core Web Vitals thresholds.
**Action:** Run the `pagespeed-95` skill script against key URLs.
**Why Fifth:** Performance is the final polish. It affects ranking and user retention after the page has been discovered and understood.

## Automated Master Audit Script

Use the provided master script to run all checks sequentially on a target URL.

**Usage:**
```bash
python /home/ubuntu/skills/maintenance-orchestrator/scripts/run_full_audit.py <url> [pagespeed_api_key]
```