This skill should be used when auditing, fixing, or validating SEO and AEO (AI Engine Optimization) for Eleventy documentation sites. It provides sub-commands for running audits, applying fixes, and validating build output.
From soleurnpx claudepluginhub jikig-ai/soleur --plugin soleurThis skill uses the workspace's default tool permissions.
scripts/validate-csp.shscripts/validate-seo.shAudit, fix, and validate SEO and AEO (AI Engine Optimization) for Eleventy documentation sites. This skill routes to sub-commands for analysis, remediation, and CI validation.
| Command | Description |
|---|---|
seo-aeo audit | Audit the site for SEO/AEO issues and produce a report |
seo-aeo fix | Analyze gaps and apply fixes to source files |
seo-aeo validate | Run the validation script against built output |
If no sub-command is provided, display the table above and ask which sub-command to run.
<critical_sequence>
Before executing any sub-command, verify the Eleventy site structure exists.
Required: Eleventy config
if [[ ! -f "eleventy.config.js" ]] && [[ ! -f ".eleventy.js" ]]; then
echo "No Eleventy config found. This skill works with Eleventy documentation sites."
# Stop execution
fi
Required for validate: Built output
The validate sub-command requires a built _site/ directory. If missing:
No
_site/directory found. Runnpx @11ty/eleventyfirst, then re-run validate.
</critical_sequence>
Run a comprehensive SEO/AEO audit using the seo-aeo-analyst agent.
Launch the seo-aeo-analyst agent via the Task tool:
Task seo-aeo-analyst: "Audit this Eleventy documentation site for SEO and AEO issues.
Read the site configuration, templates, and data files. Produce a structured report
with critical issues, warnings, and passed checks. Do NOT make any changes."
Present the agent's report to the user
Offer next steps: "Run seo-aeo fix to apply recommended fixes, or seo-aeo validate to check the built output."
Analyze gaps and apply targeted fixes to source files.
Launch the seo-aeo-analyst agent via the Task tool with fix instructions:
Task seo-aeo-analyst: "Audit this Eleventy documentation site for SEO and AEO issues.
For each issue found, apply a fix to the source files. Read each file before editing.
After all fixes, build the site with `npx @11ty/eleventy` and run
`bash plugins/soleur/skills/seo-aeo/scripts/validate-seo.sh _site` and
`bash plugins/soleur/skills/seo-aeo/scripts/validate-csp.sh _site` to verify.
Report what was changed and whether validation passed."
Present the agent's report showing changes made
If validation failed, show the failing checks and offer to re-run fix
Run the standalone validation script against built output.
Verify _site/ exists. If not, build first:
npx @11ty/eleventy
Run the validation scripts:
bash plugins/soleur/skills/seo-aeo/scripts/validate-seo.sh _site
bash plugins/soleur/skills/seo-aeo/scripts/validate-csp.sh _site
Report results:
seo-aeo fixValidation scripts:
Known limitations:
User-agent: * blocks are not detected. A site blocking all bots via wildcard will pass validation.