К основному содержанию
скилл CX Codex

best-practices · tech-leads-club — скилл для Claude Code: что делает и как установить

Скилл best-practices для Claude Code проверяет веб-код на проблемы безопасности, совместимости с браузерами и качества. Запускается по запросу на аудит или модернизацию кода.

MIT ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add tech-leads-club/agent-skills --skill best-practices -a claude-code
Открыть на GitHub

Что делает best-practices

Скилл best-practices помогает находить уязвимые шаблоны и применять практики для веб-кода. Он разбирает настройки HTTPS и CSP, защитные HTTP-заголовки, обработку пользовательского ввода и зависимости. Также проверяет HTML-разметку, поддержку возможностей браузера и использование устаревших API.

В примерах есть команды npm audit и yarn audit, а для HTML — корректный DOCTYPE и метатег viewport. Скилл подключается по запросам на проверку безопасности, качества кода или модернизацию. Доступность, SEO, производительность и комплексный аудит относятся к другим скиллам.

Какие задачи решает

  • найти небезопасную обработку пользовательского ввода
  • проверить настройки HTTPS и CSP
  • выявить уязвимые зависимости
  • заменить устаревшие браузерные API
  • проверить HTML-разметку на совместимость

Примеры запросов агенту

  • Проведи аудит безопасности веб-кода.
  • Проверь этот проект на уязвимые зависимости и небезопасную обработку ввода.
  • Модернизируй код с учётом совместимости с браузерами.

Как установить best-practices

1Через Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill best-practices -a claude-code

2Вручную: положить файлы

~/.claude/skills/web-best-practices/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/web-best-practices/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о best-practices

Как установить best-practices в Claude Code?

Выполни npx skills add tech-leads-club/agent-skills --skill best-practices -a claude-code.

Что делает best-practices?

Скилл помогает проверять веб-код на проблемы безопасности, совместимости с браузерами и качества. Он охватывает, среди прочего, CSP, HTTP-заголовки, ввод пользователя и устаревшие API.

Какие проверки входят в best-practices?

Скилл предназначен для проверок безопасности, браузерной совместимости и качества кода. Для аудита доступности, SEO, производительности или нескольких областей сразу предусмотрены другие скиллы.

Исходный текст

SKILL.md · MIT
---
name: best-practices
description: Apply modern web development best practices for security, compatibility, and code quality. Use when asked to "apply best practices", "security audit", "modernize code", "code quality review", or "check for vulnerabilities". Do NOT use for accessibility (use web-accessibility), SEO (use seo), performance (use core-web-vitals), or comprehensive multi-area audits (use web-quality-audit).
license: MIT
metadata:
  author: web-quality-skills
  version: '1.0'
---

# Best practices

Modern web development standards based on Lighthouse best practices audits. Covers security, browser compatibility, and code quality patterns.

## Security

### HTTPS everywhere

**Enforce HTTPS:**

```html
<!-- ❌ Mixed content -->
<img src="http://example.com/image.jpg" />
<script src="http://cdn.example.com/script.js"></script>

<!-- ✅ HTTPS only -->
<img src="https://example.com/image.jpg" />
<script src="https://cdn.example.com/script.js"></script>

<!-- ✅ Protocol-relative (will use page's protocol) -->
<img src="//example.com/image.jpg" />
```

**HSTS Header:**

```
Strict-Transport-Security: max-age=31536000; includeSubDomains; preload
```

### Content Security Policy (CSP)

```html
<!-- Basic CSP via meta tag -->
<meta
  http-equiv="Content-Security-Policy"
  content="default-src 'self'; 
               script-src 'self' https://trusted-cdn.com; 
               style-src 'self' 'unsafe-inline';
               img-src 'self' data: https:;
               connect-src 'self' https://api.example.com;"
/>

<!-- Better: HTTP header -->
```

**CSP Header (recommended):**

```
Content-Security-Policy:
  default-src 'self';
  script-src 'self' 'nonce-abc123' https://trusted.com;
  style-src 'self' 'nonce-abc123';
  img-src 'self' data: https:;
  connect-src 'self' https://api.example.com;
  frame-ancestors 'self';
  base-uri 'self';
  form-action 'self';
```

**Using nonces for inline scripts:**

```html
<script nonce="abc123">
  // This inline script is allowed
</script>
```

### Security headers

```
# Prevent clickjacking
X-Frame-Options: DENY

# Prevent MIME type sniffing
X-Content-Type-Options: nosniff

# Enable XSS filter (legacy browsers)
X-XSS-Protection: 1; mode=block

# Control referrer information
Referrer-Policy: strict-origin-when-cross-origin

# Permissions policy (formerly Feature-Policy)
Permissions-Policy: geolocation=(), microphone=(), camera=()
```

### No vulnerable libraries

```bash
# Check for vulnerabilities
npm audit
yarn audit

# Auto-fix when possible
npm audit fix

# Check specific package
npm ls lodash
```

**Keep dependencies updated:**

```json
// package.json
{
  "scripts": {
    "audit": "npm audit --audit-level=moderate",
    "update": "npm update && npm audit fix"
  }
}
```

**Known vulnerable patterns to avoid:**

```javascript
// ❌ Prototype pollution vulnerable patterns
Object.assign(target, userInput)
_.merge(target, userInput)

// ✅ Safer alternatives
const safeData = JSON.parse(JSON.stringify(userInput))
```

### Input sanitization

```javascript
// ❌ XSS vulnerable
element.innerHTML = userInput
document.write(userInput)

// ✅ Safe text content
element.textContent = userInput

// ✅ If HTML needed, sanitize
import DOMPurify from 'dompurify'
element.innerHTML = DOMPurify.sanitize(userInput)
```

### Secure cookies

```javascript
// ❌ Insecure cookie
document.cookie = "session=abc123";

// ✅ Secure cookie (server-side)
Set-Cookie: session=abc123; Secure; HttpOnly; SameSite=Strict; Path=/
```

---

## Browser compatibility

### Doctype declaration

```html
<!-- ❌ Missing or invalid doctype -->
<html lang="en">
  <head>
    <title>Page</title>
  </head>
  <body></body>
</html>

<!-- ✅ HTML5 doctype -->
<!DOCTYPE html>
<html lang="en">
  <head>
    <title>Page</title>
  </head>
  <body></body>
</html>
```

### Character encoding

```html
<!-- ❌ Missing or late charset -->
<!DOCTYPE html>
<html lang="en">
  <head>
    <title>Page</title>
    <meta charset="UTF-8" />
  </head>
  <body></body>
</html>

<!-- ✅ Charset as first element in head -->
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Page</title>
  </head>
  <body></body>
</html>
```

### Viewport meta tag

```html
<!-- ❌ Missing viewport -->
<head>
  <title>Page</title>
</head>

<!-- ✅ Responsive viewport -->
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <title>Page</title>
</head>
```

### Feature detection

```javascript
// ❌ Browser detection (brittle)
if (navigator.userAgent.includes('Chrome')) {
  // Chrome-specific code
}

// ✅ Feature detection
if ('IntersectionObserver' in window) {
  // Use IntersectionObserver
} else {
  // Fallback
}

// ✅ Using @supports in CSS
@supports (display: grid) {
  .container {
    display: grid;
  }
}

@supports not (display: grid) {
  .container {
    display: flex;
  }
}
```

### Polyfills (when needed)

```html
<!-- Load polyfills conditionally -->
<script>
  if (!('fetch' in window)) {
    document.write('<script src="/polyfills/fetch.js"><\/script>')
  }
</script>

<!-- Or use polyfill.io -->
<script src="https://polyfill.io/v3/polyfill.min.js?features=fetch,IntersectionObserver"></script>
```

---

## Deprecated APIs

### Avoid these

```javascript
// ❌ document.write (blocks parsing)
document.write('<script src="..."></script>');

// ✅ Dynamic script loading
const script = document.createElement('script');
script.src = '...';
document.head.appendChild(script);

// ❌ Synchronous XHR (blocks main thread)
const xhr = new XMLHttpRequest();
xhr.open('GET', url, false); // false = synchronous

// ✅ Async fetch
const response = await fetch(url);

// ❌ Application Cache (deprecated)
<html manifest="cache.manifest">

// ✅ Service Workers
if ('serviceWorker' in navigator) {
  navigator.serviceWorker.register('/sw.js');
}
```

### Event listener passive

```javascript
// ❌ Non-passive touch/wheel (may block scrolling)
element.addEventListener('touchstart', handler)
element.addEventListener('wheel', handler)

// ✅ Passive listeners (allows smooth scrolling)
element.addEventListener('touchstart', handler, { passive: true })
element.addEventListener('wheel', handler, { passive: true })

// ✅ If you need preventDefault, be explicit
element.addEventListener('touchstart', handler, { passive: false })
```

---

## Console & errors

### No console errors

```javascript
// ❌ Errors in production
console.log('Debug info') // Remove in production
throw new Error('Unhandled') // Catch all errors

// ✅ Proper error handling
try {
  riskyOperation()
} catch (error) {
  // Log to error tracking service
  errorTracker.captureException(error)
  // Show user-friendly message
  showErrorMessage('Something went wrong. Please try again.')
}
```

### Error boundaries (React)

```jsx
class ErrorBoundary extends React.Component {
  state = { hasError: false }

  static getDerivedStateFromError(error) {
    return { hasError: true }
  }

  componentDidCatch(error, info) {
    errorTracker.captureException(error, { extra: info })
  }

  render() {
    if (this.state.hasError) {
      return <FallbackUI />
    }
    return this.props.children
  }
}

// Usage
;<ErrorBoundary>
  <App />
</ErrorBoundary>
```

### Global error handler

```javascript
// Catch unhandled errors
window.addEventListener('error', (event) => {
  errorTracker.captureException(event.error)
})

// Catch unhandled promise rejections
window.addEventListener('unhandledrejection', (event) => {
  errorTracker.captureException(event.reason)
})
```

---

## Source maps

### Production configuration

```javascript
// ❌ Source maps exposed in production
// webpack.config.js
module.exports = {
  devtool: 'source-map', // Exposes source code
}

// ✅ Hidden source maps (uploaded to error tracker)
module.exports = {
  devtool: 'hidden-source-map',
}

// ✅ Or no source maps in production
module.exports = {
  devtool: process.env.NODE_ENV === 'production' ? false : 'source-map',
}
```

---

## Performance best practices

### Avoid blocking patterns

```javascript
// ❌ Blocking script
<script src="heavy-library.js"></script>

// ✅ Deferred script
<script defer src="heavy-library.js"></script>

// ❌ Blocking CSS import
@import url('other-styles.css');

// ✅ Link tags (parallel loading)
<link rel="stylesheet" href="styles.css">
<link rel="stylesheet" href="other-styles.css">
```

### Efficient event handlers

```javascript
// ❌ Handler on every element
items.forEach((item) => {
  item.addEventListener('click', handleClick)
})

// ✅ Event delegation
container.addEventListener('click', (e) => {
  if (e.target.matches('.item')) {
    handleClick(e)
  }
})
```

### Memory management

```javascript
// ❌ Memory leak (never removed)
const handler = () => {
  /* ... */
}
window.addEventListener('resize', handler)

// ✅ Cleanup when done
const handler = () => {
  /* ... */
}
window.addEventListener('resize', handler)

// Later, when component unmounts:
window.removeEventListener('resize', handler)

// ✅ Using AbortController
const controller = new AbortController()
window.addEventListener('resize', handler, { signal: controller.signal })

// Cleanup:
controller.abort()
```

---

## Code quality

### Valid HTML

```html
<!-- ❌ Invalid HTML -->
<div id="header">
  <div id="header">
    <!-- Duplicate ID -->
  </div>

  <ul>
    <div>Item</div>
    <!-- Invalid child -->
  </ul>

  <a href="/"><button>Click</button></a>
  <!-- Invalid nesting -->
</div>

<!-- ✅ Valid HTML -->
<header id="site-header"></header>

<ul>
  <li>Item</li>
</ul>

<a href="/" class="button">Click</a>
```

### Semantic HTML

```html
<!-- ❌ Non-semantic -->
<div class="header">
  <div class="nav">
    <div class="nav-item">Home</div>
  </div>
</div>
<div class="main">
  <div class="article">
    <div class="title">Headline</div>
  </div>
</div>

<!-- ✅ Semantic HTML5 -->
<header>
  <nav>
    <a href="/">Home</a>
  </nav>
</header>
<main>
  <article>
    <h1>Headline</h1>
  </article>
</main>
```

### Image aspect ratios

```html
<!-- ❌ Distorted images -->
<img src="photo.jpg" width="300" height="100" />
<!-- If actual ratio is 4:3, this squishes the image -->

<!-- ✅ Preserve aspect ratio -->
<img src="photo.jpg" width="300" height="225" />
<!-- Actual 4:3 dimensions -->

<!-- ✅ CSS object-fit for flexibility -->
<img src="photo.jpg" style="width: 300px; height: 200px; object-fit: cover;" />
```

---

## Permissions & privacy

### Request permissions properly

```javascript
// ❌ Request on page load (bad UX, often denied)
navigator.geolocation.getCurrentPosition(success, error)

// ✅ Request in context, after user action
findNearbyButton.addEventListener('click', async () => {
  // Explain why you need it
  if (await showPermissionExplanation()) {
    navigator.geolocation.getCurrentPosition(success, error)
  }
})
```

### Permissions policy

```html
<!-- Restrict powerful features -->
<meta http-equiv="Permissions-Policy" content="geolocation=(), camera=(), microphone=()" />

<!-- Or allow for specific origins -->
<meta http-equiv="Permissions-Policy" content="geolocation=(self 'https://maps.example.com')" />
```

---

## Audit checklist

### Security (critical)

- [ ] HTTPS enabled, no mixed content
- [ ] No vulnerable dependencies (`npm audit`)
- [ ] CSP headers configured
- [ ] Security headers present
- [ ] No exposed source maps

### Compatibility

- [ ] Valid HTML5 doctype
- [ ] Charset declared first in head
- [ ] Viewport meta tag present
- [ ] No deprecated APIs used
- [ ] Passive event listeners for scroll/touch

### Code quality

- [ ] No console errors
- [ ] Valid HTML (no duplicate IDs)
- [ ] Semantic HTML elements used
- [ ] Proper error handling
- [ ] Memory cleanup in components

### UX

- [ ] No intrusive interstitials
- [ ] Permission requests in context
- [ ] Clear error messages
- [ ] Appropriate image aspect ratios

## Tools

| Tool                                               | Purpose                    |
| -------------------------------------------------- | -------------------------- |
| `npm audit`                                        | Dependency vulnerabilities |
| [SecurityHeaders.com](https://securityheaders.com) | Header analysis            |
| [W3C Validator](https://validator.w3.org)          | HTML validation            |
| Lighthouse                                         | Best practices audit       |
| [Observatory](https://observatory.mozilla.org)     | Security scan              |

## References

- [MDN Web Security](https://developer.mozilla.org/en-US/docs/Web/Security)
- [OWASP Top 10](https://owasp.org/www-project-top-ten/)
- [Web Quality Audit](../web-quality-audit/SKILL.md)

© web-quality-skills · MIT · tech-leads-club/agent-skills

Похожие скиллы

Все скиллы по теме «Безопасность» →

Сначала — best-practices от других авторов.

best-practices MoizIbnYousaf Скилл best-practices для Claude Code превращает сырые запросы к кодинг-агенту в структурированные промпты. Добавляет критерии проверки, ограничения и пути к файлам. CX Codex +1 533установок best-practices mobbin Скилл best-practices для Claude Code объясняет возможности и ограничения Mobbin и связь его скиллов. Читай его первым перед скиллами Mobbin, спрашивая о возможностях или начиная дизайн-задачу. CX Codex +1 1 800установок best-practices FradSer Скилл best-practices задаёт правила качества кода и шаблоны под TypeScript, Python, Go, Swift и React. CX Codex +1 115установок best-practices alexander-cedergren Скилл best-practices по Oracle Cloud: подсказывает, какой CIDR брать для VCN, почему субнеты должны быть региональными и где Cloud Guard ломает прод. CX Codex +1 121установок security parcadei Скилл security для Claude Code, Cursor и других ИИ-редакторов, который запускает двухфазовый аудит безопасности кода. CX Codex +1 534установок xss-prevention secondsky Скилл xss-prevention для Claude Code помогает закрывать XSS санитизацией ввода, кодированием вывода и CSP. Разбирает XSS-риски в пользовательском HTML, комментариях и rich text. CX Codex +1 320установок dependency-audit briiirussell Скилл dependency-audit проверяет зависимости, фреймворки и инструменты разработки на известные уязвимости и риски цепочки поставок. Пригодится перед релизом или разбором CVE. CX Codex +1 606установок web-security-review OWASP Скилл web-security-review проверяет веб-приложения по рискам OWASP Top 10 (2021) и формирует отчёт с матрицей рисков. Пригодится при аудите серверного кода, веб-фреймворков и конфигураций. CX Codex +1 881установок deps-audit Seth Hobson Команда deps-audit проверяет зависимости проекта на уязвимости, устаревшие пакеты, конфликты лицензий и риски цепочки поставок. Подходит для разбора npm, Python и Go-зависимостей. CX Codex +1 ★ 42 780звёзд репо ctf-web ljagiello Скилл ctf-web направляет агента при решении веб-задач в CTF: от разведки инъекций и обхода авторизации до SSRF и фаззинга API. CX Codex +1 10 600установок

Из того же набора130

Весь набор →
perf-lighthouse Скилл perf-lighthouse запускает аудит Lighthouse через консоль или Node API, считывает метрики и настраивает бюджеты производительности. Помогает внедрить проверки скорости в CI и разобрать JSON-отчёты. CX Codex +1 341установок codenavi Скилл codenavi помогает исследовать незнакомый код, точечно вносить правки и сохранять знания о проекте в папку .notebook/. Пригодится при отладке и рефакторинге сложных систем. CX Codex +1 327установок decomposition-planning-roadmap Скилл decomposition-planning-roadmap для Claude Code создаёт план декомпозиции монолита и дорожную карту миграции. Он подключается к задачам по выбору порядка выделения сервисов и отслеживанию работ. CX Codex +1 322установок seo Прогоняет сайт по чек-листу технического и on-page SEO: обход, canonical, sitemap, метатеги, разметка JSON-LD. Устраняет проблемы с индексацией и кривыми сниппетами в выдаче. CX Codex +1 ★ 7 191звёзд репо js-index-maps Правило js-index-maps заменяет повторные .find() по одному ключу на индекс Map. Оно пригодится при частых поисках в массивах. CX Codex +1 ★ 7 191звёзд репо rendering-hydration-suppress-warning Правило rendering-hydration-suppress-warning гасит предупреждения гидратации там, где сервер и клиент намеренно показывают разное: даты, случайные ID, форматирование по локали. CX Codex +1 ★ 7 191звёзд репо bundle-defer-third-party Правило bundle-defer-third-party запрещает прямо импортировать сторонние трекеры в начальный бандл. Агент оборачивает аналитику и логирование в динамическую загрузку после гидратации. CX Codex +1 ★ 7 191звёзд репо bundle-conditional Правило bundle-conditional предлагает загружать крупные модули только при активации функции. Оно пригодится для отложенной загрузки данных и сокращения серверного бандла при SSR. CX Codex +1 ★ 7 191звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой