audit your
static site

An open, modular, and lightning-fast static site validator—auditable, extensible, and ready for both human and AI-driven workflows.

Node.js 18+ required. Works on macOS, Linux, Windows. 522 KB
Star on GitHub
$ npx optimize

✓ Process time completed: (Total time: 1.65 seconds)
================= SUMMARY =================
❌ TOTAL CHECKS FAILED: 5
⚠️ TOTAL FAILED ITEMS: 21

FAILED CHECKS:
- Meta: 7 failed item(s)
- Open Graph: 5 failed item(s)
- Schema: 5 failed item(s)
- Hierarchy: 3 failed item(s)
- Accessibility: 1 failed item(s)

✓ Links: All passed
✓ Media: All passed
✓ Sources: All passed

Usage View Docs

Run optimize after your build step. It scans your output directory and produces structured, actionable results—perfect for CI/CD pipelines, tools and agentic workflows.

Platform
macOS / Linux / Windows
Runtime
Node.js 18+
Output
JSON / CSV / Console
Build Time
50+ pages in seconds
Static Site Generators
Eleventy, Jekyll, Hugo, Next.js, Astro

Command Examples

run all checks on build output
npx optimize
validate a specific file
npx optimize --path ./dist/index.html
run only meta and accessibility checks
npx optimize --meta --accessibility
output results to JSON for automation
npx optimize --json results.json
Power up with AI skill for agentic workflows
npm skills add @bynovl/skills --skill optimize-site

Prompt to your AI assistant: "Run optimize on my site and summarize the critical issues I need to fix before deployment."

What Can Optimize Check?

Meta Tags

Title, description, canonical, robots, and more.

Open Graph

og:image, Twitter cards, and social metadata.

Schema

JSON-LD schema.org structured data validation.

Accessibility

ARIA roles, semantic markup, and a11y features.

Links

Broken links, anchor text, internal/external.

Media

Alt text, image formats, missing or broken URLs.

Hierarchy

Heading order and document structure.

Sources

Asset references, environment leaks, build output.

Make it your own!

Modify config settings, add your own checks, or plugin to existing checks to fit your project's needs.

Why Choose Optimize?

Modular & Extensible

Checks are independent modules—add, remove, or customize. Plugin tools like Lighthouse, pa11y, and more.

Programmatic & CLI

Use as a CLI for quick audits or integrate into Node.js scripts, build tools, and CI/CD pipelines.

Local-First & Private

Your privacy matters. Runs entirely on your machine—no data sent to remote servers. Your codebase stays private.

Fast & Lightweight

Minimal dependencies, 522 KB unpacked, rapid execution. 50+ pages in seconds.

AI-Native & Agentic

Structured output for AI assistants and agentic workflows. Pairs with the optimize SKILL.

Community-Driven

100% open source. No hidden binaries, no vendor lock-in. Contributions welcome.