e2b-audit

E2B Audit Skill

Run comprehensive accessibility and SEO audits in isolated e2b cloud sandboxes using Lighthouse, axe-core, and pa11y.

When to Use

Activate this skill when:

• User asks for accessibility audit/check
• User asks for SEO audit/analysis
• User mentions WCAG compliance
• User wants to run Lighthouse, axe, or pa11y
• User says "audit my site" or similar

Prerequisites Check

Before running, verify:

# Check for API key
echo $E2B_API_KEY

If not set, inform user:

E2B_API_KEY is required. Get your key at https://e2b.dev/dashboard

Workflow

Step 1: Prepare

1. Check for e2b-tools.config.ts in project root
2. If not present, ask user about their dev server setup:
   • What command starts the dev server? (default: npm run dev)
   • What port does it run on? (default: 4321)

Step 2: Run Audit

Execute the audit CLI:

npx e2b-audit run --verbose

Or with specific options:

# Specific tools only
npx e2b-audit run --tools lighthouse,axe --verbose

# Custom dev server
npx e2b-audit run --dev-command "npm run dev" --dev-port 3000 --verbose

# Custom output location
npx e2b-audit run --output docs/accessibility --verbose

Step 3: Review Results

After audit completes, results are in docs/audits/:

• lighthouse.json - Performance, accessibility, SEO scores
• axe.json - Detailed accessibility violations
• pa11y.json - Additional accessibility issues

Read and summarize findings:

# Check what was generated
ls -la docs/audits/

Step 4: Report Summary

Provide user with:

1. Scores (from Lighthouse):

   • Performance: X/100
   • Accessibility: X/100
   • Best Practices: X/100
   • SEO: X/100

2. Critical Issues (severity: critical/serious):

   • List top issues from axe/pa11y
   • Include affected elements/selectors

3. Recommendations:

   • Prioritized fixes
   • WCAG criteria affected

Step 5: Offer Remediation

Ask user:

Would you like me to generate remediation specs for these issues?

If yes, create specs in docs/accessibility/specs/ or docs/seo/specs/ following the project's spec format.

Configuration

If user needs custom config, help create e2b-tools.config.ts:

import { defineConfig } from '@e2b-tools/core';

export default defineConfig({
  base: {
    sandbox: {
      timeout: 300, // 5 minutes
    },
    devServer: {
      port: 4321,
      command: 'npm run dev',
    },
  },
  audit: {
    tools: {
      lighthouse: true,
      axe: true,
      pa11y: true,
    },
    output: {
      dir: 'docs/audits',
      format: 'json',
    },
  },
});

Troubleshooting

Sandbox timeout

Increase timeout in config or CLI:

npx e2b-audit run --timeout 600

Dev server not starting

Check the command and port match your project's setup.

Missing API key

export E2B_API_KEY=your_key_here

Example Interaction

User: "Can you audit my site for accessibility issues?"

Assistant:

1. Check E2B_API_KEY is set
2. Run npx e2b-audit run --verbose
3. Wait for completion
4. Read results from docs/audits/
5. Summarize findings
6. Offer to create remediation specs