style-lint

name

style_lint

description

Scan Warp Astro Starlight documentation for style guide violations including formatting issues (Settings path format, UI element format, link quality, VideoEmbed titles, header case, missing frontmatter, image alt text, standardized screenshot widths, callout syntax) and terminology issues (product name casing, Oz terms to avoid, deprecated terms). Run with --changed for PR workflows or --all for periodic audits. Optionally auto-fix high-confidence issues with --fix.

Style Lint

Scan Warp Astro Starlight documentation for formatting and terminology issues defined in the style guide (AGENTS.md).

Running the check

From the docs repo root:

python3 .agents/skills/style_lint/style_lint.py

Options

• --all: Scan all markdown files in src/content/docs/ (default)
• --changed: Scan only files changed in the current branch (fast, for PR workflows)
• --fix: Auto-fix high-confidence issues (optional, off by default)
• --create-pr: Create a branch and PR with auto-fixes (requires gh CLI, implies --fix)
• --output FILE: Save results to JSON file
• --slack-notify: Send results to Slack (only sends when issues are found; requires SLACK_BOT_TOKEN and GROWTH_DOCS_SLACK_CHANNEL_ID env vars)
• --slack-channel ID: Override the default Slack channel

Quick check on changed files:

python3 .agents/skills/style_lint/style_lint.py --changed

Full audit with auto-fix and PR:

python3 .agents/skills/style_lint/style_lint.py --all --fix --create-pr