Full-stack website & GitHub repo auditor. Paste a URL or GitHub repo → get scores for performance, SEO, accessibility, security, structured data, and AI readiness → download a ready-to-run AI agent brief (AGENTS.md, CLAUDE.md, GEMINI.md, skill files) that fixes every detected issue.
| Pillar | Sources |
|---|---|
| Performance | Google PageSpeed Insights, Chrome UX Report (real users) |
| SEO | Meta tags, canonical, OG/Twitter, robots.txt, sitemap, TTFB |
| Accessibility | axe-core (WCAG 2.1 A/AA/AAA) — Phase 2 |
| Security | Mozilla Observatory, direct header check, SSL/TLS |
| Structured Data | JSON-LD detection, schema.org type validation |
| AI Readiness | llms.txt, AGENTS.md, robots.txt AI clauses, OG completeness |
| Repo Health | README, LICENSE, CI/CD, Dependabot, CONTRIBUTING, SECURITY |
After auditing, AuditKit generates a downloadable ZIP:
auditkit-brief-yoursite.com/
├── AGENTS.md ← master brief with all issues + fix instructions
├── CLAUDE.md ← Claude Code-specific instructions
├── GEMINI.md ← Gemini-specific instructions
├── llms.txt ← template to add to your site
├── .agents/skills/
│ ├── performance/SKILL.md
│ ├── seo/SKILL.md
│ ├── security/SKILL.md
│ └── ... ← one per affected pillar
├── checklists/ ← per-pillar fix checklists
└── ready-to-deploy/
├── robots.txt ← generated, ready to commit
├── security-headers.next.js
└── structured-data.jsonld
No other tool generates fix-ready agent briefs. This is the gap AuditKit fills.
- Framework: Next.js 15, TypeScript, React 19
- UI: Tailwind CSS v4, shadcn/ui principles
- Monorepo: pnpm workspaces + Turborepo
- Packages:
@auditkit/collectors,@auditkit/scorer,@auditkit/analyzer,@auditkit/generator - Infra: Google Cloud Run + Cloud Tasks (long-running Playwright collectors)
# Clone
git clone https://github.com/nirholas/AuditKit
cd AuditKit
# Install
pnpm install
# Configure
cp .env.example .env
# Add GOOGLE_API_KEY for PageSpeed + CrUX
# Add GITHUB_TOKEN for higher GitHub API rate limits (optional)
# Run
pnpm dev
# → http://localhost:3000auditkit/
├── apps/web/ ← Next.js 15 frontend + API routes
├── packages/
│ ├── collectors/ ← one file per data source (pagespeed, crux, github, etc.)
│ ├── scorer/ ← converts raw data → pillar scores + issues
│ ├── analyzer/ ← orchestrates collectors in parallel
│ └── generator/ ← converts scores → AI agent brief ZIP
| API | Free? | Requires Key? |
|---|---|---|
| Google PageSpeed Insights | ✅ | Optional (quota) |
| Chrome UX Report (CrUX) | ✅ | Required |
| Mozilla Observatory | ✅ | No |
| GitHub REST API | ✅ | Optional (rate limits) |
| W3C Nu Validator | ✅ | No |
| Website Carbon API | ✅ | No |
- Phase 1: URL audit (PageSpeed, CrUX, meta, security) ✅
- Phase 2: axe-core accessibility via Playwright
- Phase 3: GitHub repo scanning ✅
- Phase 4: AI brief generator ✅
- Phase 5: GCP Cloud Run workers for long-running collectors
- Phase 6: Side-by-side comparison, share links, diff re-runs
See CONTRIBUTING.md. PRs welcome.
MIT