Audit docs with AI agent
The Analyze Do11y data skill turns your Do11y data into a prioritized list of documentation improvements. It runs in an AI agent and queries your Supabase database directly, checks for instrumentation gaps, and produces a structured audit report.
Prerequisites
Before running the skill, get your Supabase database connection string from Settings > Database in the Supabase dashboard.
Run the audit
Copy the Analyze Do11y data skill into the AI agent and ask it to analyze your docs:
Analyze my Do11y data. Database URL:
https://abc123.supabase.co, secret key:sb_secret_...
Optionally, define the table name and time range for the audit.
The agent picks up the skill automatically. It queries your database, checks for common instrumentation gaps, and returns a report.
What the report covers
The agent organizes output into seven sections:
- Instrumentation gaps: Flags any tracking issues before interpreting content metrics. This helps you know which findings to trust.
- Traffic overview: Top entry points, section volumes, and traffic source breakdown.
- Engagement problems: High-traffic pages with low scroll depth or active time.
- Confusion signals: Pages where users frequently open search or rely heavily on the TOC.
- High-performing content: Pages with strong completion rates to use as rewrite templates.
- Routing issues: Paths outside the expected URL structure and suspected 404s.
- Prioritized actions: Immediate content changes, short-term redirects, and instrumentation fixes.
For individual SQL queries to explore your data on your own, see Example queries.