aeo

This Skill addresses the need for Answer Engine Optimization (AEO) auditing and diagnostics for websites. In practical development, developers often need to evaluate a website's visibility in scenarios like AI search and voice assistants, but traditional SEO tools fail to cover the scoring dimensions specific to answer engines. It also handles complex scenarios such as preview branch audits, changed-page sitemap audits, and local/private preview audits, helping teams identify optimization opportunities before launch.

Usage is straightforward: simply run npx @ainyc/aeo-audit@1 "<url>" [flags] --format json in your terminal. You can then execute different tasks by specifying a mode (audit, fix, schema, llms, monitor, detect-platform, compare). For example, running audit https://example.com --sitemap performs a batch audit of the entire sitemap, returning an overall score, factor breakdown, strengths, and improvement suggestions. It also supports a static output mode (audit ./out) for offline auditing of pre-built HTML files.

It is well-suited for teams or individuals requiring continuous optimization of their website's AI visibility. This is especially true for teams already using CI/CD pipelines who wish to automate AEO regression testing before each deployment. E-commerce operators, content creators, and SEO specialists can use it to quickly pinpoint performance gaps of their pages within answer engines and generate actionable remediation plans. Furthermore, it supports competitor comparison (monitor --compare) and regression comparison (compare --baseline --current), making it suitable for long-term monitoring.

We recommend integrating this tool into your CI/CD pipeline, using the --require-meta flag as a quality gate to enforce the inclusion of necessary metadata on every page. Note that it primarily targets publicly accessible URLs or local static outputs; for private pages requiring login, flags like --allow-local and --rewrite-sitemap-origin are needed. Additionally, all user input must undergo strict security validation to mitigate shell injection risks.