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
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a claude-codeWhat 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.htmlandstyles.cssbefore 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-code2Manually: put the files in place
~/.claude/skills/generic-static-code-reviewer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/generic-static-code-reviewer/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a codex2Manually: put the files in place
.agents/skills/generic-static-code-reviewer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a cursor2Manually: put the files in place
.cursor/skills/generic-static-code-reviewer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install travisjneuman/.claude skills/generic-static-code-reviewer2Manually: put the files in place
.github/skills/generic-static-code-reviewer/SKILL.md1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a gemini-cli2Platform CLI
gemini skills install https://github.com/travisjneuman/.claude --path skills/generic-static-code-reviewerManually: put the files in place
.devin/skills/generic-static-code-reviewer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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