generic-static-code-reviewer — скилл для Claude Code: ревью статики
Скилл generic-static-code-reviewer проверяет HTML, CSS и JS статического сайта: баги, безопасность, вес, доступность. Сборку вроде Sass или бандлера считает нарушением.
MIT 149 установок ★ 114 обновлён 2026-10-25
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a claude-codeЧто делает generic-static-code-reviewer
Скилл читает HTML, CSS и JS статической страницы и раскладывает замечания по шкале P0/P1/P2, которую берёт из базового generic-code-reviewer. Смотрит разметку, безопасность, доступность, вес файлов и то, как код следует правилам проекта из CLAUDE.md. Ждёт чистые .html, .css и .js: шаблонизатор, Sass/Less или бандлер для него нарушение, поэтому на собранном проекте половина замечаний будет мимо.
Внутри есть чек-лист перед коммитом. Сервер поднимают через python -m http.server 8000 или npx serve ., страницу смотрят в Chrome, Firefox и Safari на ширине 375px, 768px и 1024px, потом гоняют Lighthouse. Бюджеты по весу: HTML до 5KB, CSS до 10KB, JS до 5KB, вся страница без картинок до 50KB, каждая картинка до 500KB.
Отдельно прописаны цели Lighthouse: Performance 95+, Accessibility 90+, Best Practices и SEO по 100, First Contentful Paint укладывается в 1s. В разметке нужны семантические header, main и article, в CSS — кастомные свойства и mobile-first, в JS — ES6 с делегированием событий и без jQuery. Скилл опирается на базовый generic-code-reviewer: без него остаётся голый список галочек, без методики и приоритетов.
Какие задачи решает
- прогнать HTML, CSS и JS перед коммитом
- найти разметку без семантики и картинки без alt
- взвесить страницу и уложить её в 50KB
- поднять Lighthouse Performance до 95+
- вычистить !important и остатки jQuery
Примеры запросов агенту
- Проверь
index.htmlиstyles.cssперед коммитом: разметка, вес, доступность. - Подними страницу через
npx serve .и пройди чек-лист на ширине 375px, 768px и 1024px. - Сделай ревью
main.js: делегирование событий, ES6, никакого jQuery.
Как установить generic-static-code-reviewer
1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a claude-code2Вручную: положить файлы
~/.claude/skills/generic-static-code-reviewer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/generic-static-code-reviewer/
1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a codex2Вручную: положить файлы
.agents/skills/generic-static-code-reviewer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a cursor2Вручную: положить файлы
.cursor/skills/generic-static-code-reviewer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install travisjneuman/.claude skills/generic-static-code-reviewer2Вручную: положить файлы
.github/skills/generic-static-code-reviewer/SKILL.md1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a gemini-cli2Командой платформы
gemini skills install https://github.com/travisjneuman/.claude --path skills/generic-static-code-reviewerВручную: положить файлы
.devin/skills/generic-static-code-reviewer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о generic-static-code-reviewer
Как установить generic-static-code-reviewer в Claude Code?
Выполните npx skills add travisjneuman/.claude --skill generic-static-code-reviewer -a claude-code, файл скилла появится по пути ~/.claude/skills/generic-static-code-reviewer/SKILL.md.
Что делает generic-static-code-reviewer?
Проверяет код статического сайта на баги, проблемы безопасности, вес страниц и провалы по доступности, расставляя замечания по приоритетам P0/P1/P2. Дополнительно сверяет код с правилами проекта из CLAUDE.md.
Нужен ли базовый скилл generic-code-reviewer?
Да, этот скилл его расширяет: методика ревью и шкала P0/P1/P2 описаны в generic-code-reviewer, здесь только надстройка под статику. Без базового скилла проверки сведутся к чек-листу.
Исходный текст
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