Skip to main content
skill CX Codex

generic-static-code-reviewer — Claude Code skill: static site review

generic-static-code-reviewer is a skill that checks static-site HTML, CSS and JS for bugs, security issues, page weight and accessibility before a commit.

MIT 149 installs ★ 114 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a claude-code
Open on GitHub

What generic-static-code-reviewer does

The skill goes through HTML, CSS and JS on a static page and sorts findings into P0/P1/P2, the scale it inherits from the base generic-code-reviewer. Markup, security, accessibility, file weight and adherence to the project's CLAUDE.md all get looked at. Plain .html, .css and .js only: a Sass pipeline or a bundler counts as a violation, so on a built project plenty of the output is noise.

A pre-commit checklist ships with it. Start a local server with python -m http.server 8000 or npx serve ., view the page in Chrome, Firefox and Safari at 375px, 768px and 1024px, then run Lighthouse. Weight budgets: HTML up to 5KB, CSS up to 10KB, JS up to 5KB, the whole page up to 50KB without images, each image up to 500KB.

Lighthouse targets are spelled out too: Performance 95+, Accessibility 90+, Best Practices 100, SEO 100, First Contentful Paint within 1s. Expect semantic header, main and article in markup, custom properties and a mobile-first order in CSS, ES6 with event delegation and no jQuery in JS. It builds on the base generic-code-reviewer, so install that one as well — otherwise the review has no method and no priority scale behind it.

What it helps with

  • review markup, styles and scripts before a commit
  • catch non-semantic HTML and images without alt text
  • cut page weight to fit the 50KB budget
  • push Lighthouse Performance to 95+
  • strip !important and leftover jQuery

Example prompts for the agent

  • Review index.html and styles.css before I commit — markup, weight, accessibility.
  • Start the page with npx serve . and check it at 375px, 768px and 1024px.
  • Look at main.js: event delegation, ES6, no jQuery.

How to install generic-static-code-reviewer

1Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a claude-code

2Manually: put the files in place

~/.claude/skills/generic-static-code-reviewer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/generic-static-code-reviewer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about generic-static-code-reviewer

How do I install generic-static-code-reviewer in Claude Code?

Run npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a claude-code; the skill file then sits at ~/.claude/skills/generic-static-code-reviewer/SKILL.md.

What does generic-static-code-reviewer do?

It reviews static site code for bugs, security issues, page weight and accessibility gaps, ranking findings as P0/P1/P2. It also checks whether the code follows the project's CLAUDE.md. It extends the base generic-code-reviewer, which carries the review method.

Will it work on a project with a build step?

Not well. The skill expects files served as-is, so templating, Sass/Less and bundling are flagged as violations rather than reviewed.

Source text

SKILL.md · MIT
---
name: generic-static-code-reviewer
description: Review static site code for bugs, security issues, performance problems, accessibility gaps, and CLAUDE.md compliance. Enforces pure HTML/CSS/JS standards, minimal page weight, mobile-first design. Use when completing features, before commits, or reviewing changes.
---

# Static Site Code Reviewer

Review HTML/CSS/JS code against production quality standards.

**Extends:** [Generic Code Reviewer](../generic-code-reviewer/SKILL.md) - Read base skill for full code review methodology, P0/P1/P2 priority system, and judgment calls.

## Pre-Commit Checklist

```bash
# Local testing (cross-platform options)
python -m http.server 8000   # Windows
python3 -m http.server 8000  # macOS/Linux
npx serve .                  # Node.js (recommended - all platforms)

# Visual inspection
# - Test in Chrome, Firefox, Safari
# - Test at 375px, 768px, 1024px
# - Lighthouse audit
```

- [ ] Visual inspection passed
- [ ] Works in all major browsers
- [ ] Responsive at all breakpoints
- [ ] Lighthouse Performance 95+

## Static-Specific Checks

### No Build Tools Verification

Files should be served as-is:

- Pure `.html` files (no templating)
- Pure `.css` files (no Sass/Less)
- Pure `.js` files (no bundling/transpilation)
- No `node_modules` required for production

### Page Weight Targets (P1)

| Target                   | Max Size   |
| ------------------------ | ---------- |
| HTML                     | < 5KB      |
| CSS                      | < 10KB     |
| JavaScript               | < 5KB      |
| **Total (excl. images)** | **< 50KB** |
| Images (each)            | < 500KB    |

### HTML Quality

```html
<!-- Semantic structure -->
<header>
  <nav><a href="#">Link</a></nav>
</header>
<main>
  <article>
    <h1>Title</h1>
    <p>Content</p>
  </article>
</main>
<footer></footer>

<!-- Void elements (no closing slash needed in HTML5) -->
<img src="image.jpg" alt="Description" />
<br />
<input type="text" />
```

### CSS Quality

```css
/* CSS custom properties for theming */
:root {
  --bg-primary: #000000;
  --text-primary: #ffffff;
  --accent: #00ff00;
}

/* Mobile-first responsive */
.container {
  padding: 1rem;
}

@media (min-width: 768px) {
  .container {
    padding: 2rem;
  }
}

/* Avoid !important - signals specificity problems */
```

### JavaScript Quality

```javascript
// ES6+ syntax (modern browsers support it)
const items = document.querySelectorAll(".item");
const handler = (e) => console.log(e.target);

// Event delegation (preferred)
document.body.addEventListener("click", (e) => {
  if (e.target.matches(".button")) {
    handleClick(e.target);
  }
});

// No jQuery dependencies
// No framework overhead
```

## Lighthouse Requirements (P1)

| Metric                 | Target |
| ---------------------- | ------ |
| Performance            | 95+    |
| Accessibility          | 90+    |
| Best Practices         | 100    |
| SEO                    | 100    |
| First Contentful Paint | < 1s   |

## See Also

- [Generic Code Reviewer](../generic-code-reviewer/SKILL.md) - Base methodology
- [Code Review Standards](../_shared/CODE_REVIEW_STANDARDS.md) - Full requirements
- [Design Patterns](../_shared/DESIGN_PATTERNS.md) - UI consistency

© travisjneuman · MIT · travisjneuman/.claude

Similar skills

All skills for Code review and refactoring →

From the same set117

The whole set →
pwa-development The pwa-development Claude Code skill guides work on installable web apps with offline support. It activates for PWA builds, service worker setup, and offline-first features. CX Codex +1 150installs sales sales guides B2B deal qualification, revenue forecasting, and pipeline reviews inside your coding agent. CX Codex +1 150installs onboarding-guide-creator onboarding-guide-creator builds role-specific onboarding plans with timelines, tasks, and milestones. Use it to draft a new hire welcome guide or training program. CX Codex +1 150installs customer-persona-builder customer-persona-builder builds ICPs, buyer personas and user archetypes from templates, with a weighted scoring matrix and interview questions behind them. CX Codex +1 149installs podcast-producer podcast-producer is a Claude Code skill that helps plan a podcast launch, prepare episodes, and create show notes. It covers the workflow from episode idea to publication. CX Codex +1 148installs generic-react-code-reviewer generic-react-code-reviewer walks your React/TypeScript diff for bugs, security holes, render costs and accessibility gaps. Fits right before a commit or when a pull request lands on your desk. CX Codex +1 148installs security This Claude Code skill covers security architecture, incident response, and vulnerability assessment. It activates for security program design, incident handling, and reviews against frameworks such as NIST and ISO 27001. CX Codex +1 148installs generic-code-reviewer generic-code-reviewer inspects code diffs for security risks, runtime errors, bundle bloat, and WCAG AA gaps. It adapts checks to your project stack and enforces workflow rules from CLAUDE.md. CX Codex +1 147installs

Project sponsors

Companies that keep this analytics open