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

xss-prevention — скилл для Claude Code: установка

Скилл xss-prevention для Claude Code помогает закрывать XSS санитизацией ввода, кодированием вывода и CSP. Разбирает XSS-риски в пользовательском HTML, комментариях и rich text.

MIT 320 установок ★ 250 обновлён 2026-10-20

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

Что делает xss-prevention

Скилл разбирает stored, reflected, DOM-based и mutation XSS. Он подсказывает, как кодировать данные по контексту: HTML, атрибуты, JavaScript, URL или CSS. Для rich text используется allowlist-санитизация через DOMPurify, а для URL — проверка протоколов http: и https:.

В материалах есть примеры для Node.js, Express и React: безопасная работа с textContent, setAttribute и document.createTextNode, настройка CSP-заголовков с nonce, а также запреты для eval(), document.write() и пользовательских данных в innerHTML. Есть ссылки на реализации для Python, Flask и Django. Использование dangerouslySetInnerHTML без DOMPurify.sanitize оставляет rich text-поле XSS-риском.

Скилл устанавливается для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для работы с HTML в примерах нужен DOMPurify, а серверные сценарии опираются на Node.js и Express.

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

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

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

  • Проверь форму комментариев на stored и reflected XSS и предложи исправления.
  • Санитизируй HTML из RichContent через DOMPurify с allowlist тегов и атрибутов.
  • Настрой для Express CSP с nonce и убери небезопасные вызовы innerHTML и eval().

Как установить xss-prevention

1Через Skills CLI (Vercel)

npx skills add secondsky/claude-skills --skill xss-prevention -a claude-code

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

~/.claude/skills/xss-prevention/SKILL.md

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

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

Вопросы о xss-prevention

Как установить xss-prevention в Claude Code?

Выполните npx skills add secondsky/claude-skills --skill xss-prevention -a claude-code, затем проверьте файл ~/.claude/skills/xss-prevention/SKILL.md.

Что делает xss-prevention?

Скилл помогает предотвращать XSS через санитизацию ввода, контекстное кодирование вывода, безопасные DOM API и Content Security Policy. Он охватывает stored, reflected, DOM-based и mutation XSS.

Нужен ли DOMPurify для rich text?

Для HTML из rich text скилл предлагает DOMPurify и allowlist разрешённых тегов и атрибутов. В React очищенный результат можно передавать в dangerouslySetInnerHTML.

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

SKILL.md · MIT
---
name: xss-prevention
description: "XSS attack prevention with input sanitization, output encoding, Content Security Policy. Use for user-generated content, rich text editors, web application security, or encountering stored XSS, reflected XSS, DOM manipulation, script injection errors."

metadata:
  keywords:
    - sanitization
    - HTML-encoding
    - DOMPurify
    - CSP
    - Content-Security-Policy
    - rich-text-editor
    - user-input
    - escaping
    - innerHTML
    - DOM-manipulation
    - stored-XSS
    - reflected-XSS
    - input-validation
    - output-encoding
    - trusted-types
    - XSS-attacks
    - web-security
    - user-generated-content
    - secure-coding
    - script-injection
    - DOM-based-XSS

license: MIT
---
# XSS Prevention

## Overview

Implement comprehensive Cross-Site Scripting attack prevention through input sanitization, output encoding, Content Security Policy headers, and secure coding practices.

## When to Use

- User-generated content display
- Rich text editors
- Comment systems
- Search functionality
- Dynamic HTML generation
- Template rendering scenarios

## XSS Attack Types

| Type | Vector | Defense |
|------|--------|---------|
| Reflected | URL parameters | Output encoding |
| Stored | Database content | Input sanitization |
| DOM-based | Client-side JS | Safe DOM APIs |
| Mutation | HTML parser quirks | Strict sanitization |

## Output Encoding (Node.js)

```javascript
function encodeHTML(str) {
  return str
    .replace(/&/g, '&')
    .replace(/</g, '&lt;')
    .replace(/>/g, '&gt;')
    .replace(/"/g, '&quot;')
    .replace(/'/g, '&#x27;');
}

function encodeForAttribute(str) {
  return str.replace(/[^\w.-]/g, char =>
    `&#x${char.charCodeAt(0).toString(16)};`
  );
}

// Usage in templates
app.get('/profile', (req, res) => {
  const username = encodeHTML(req.query.name);
  res.send(`<h1>Welcome, ${username}</h1>`);
});
```

## DOMPurify Sanitization

```javascript
import DOMPurify from 'dompurify';

const config = {
  ALLOWED_TAGS: ['b', 'i', 'em', 'strong', 'a', 'p', 'br'],
  ALLOWED_ATTR: ['href', 'title'],
  ALLOW_DATA_ATTR: false
};

function sanitizeHTML(dirty) {
  return DOMPurify.sanitize(dirty, config);
}

// React component
function RichContent({ html }) {
  return (
    <div dangerouslySetInnerHTML={{ __html: sanitizeHTML(html) }} />
  );
}
```

## Content Security Policy

```javascript
// Express middleware
app.use((req, res, next) => {
  const nonce = crypto.randomBytes(16).toString('base64');
  res.locals.nonce = nonce;

  res.setHeader('Content-Security-Policy', [
    "default-src 'self'",
    `script-src 'self' 'nonce-${nonce}'`,
    "style-src 'self' 'unsafe-inline'",
    "img-src 'self' data: https:",
    "connect-src 'self' https://api.example.com",
    "frame-ancestors 'none'",
    "base-uri 'self'",
    "form-action 'self'"
  ].join('; '));

  next();
});
```

## Safe DOM APIs

❌ NEVER do any of the following with user-controlled input — these are XSS
sinks and there is no safe way to call them with untrusted data:

- Assign it to `element.innerHTML` / `element.outerHTML`
- Pass it to `eval()`
- Pass it to `document.write()`
- Pass it to `setTimeout` / `setInterval` as a string
- Insert it into an inline event handler (e.g. `onclick="..."`)

```javascript
// SAFE — use these instead
element.textContent = userInput;      // Escaped automatically
element.setAttribute('data-id', id);  // Safe for attributes
document.createTextNode(userInput);   // Creates safe text node
```

The safe patterns above (`textContent`, attribute escaping via `setAttribute`,
`DOMPurify.sanitize`) are the only correct ways to handle user input in the DOM.

## URL Validation

```javascript
function isSafeURL(url) {
  try {
    const parsed = new URL(url);
    return ['http:', 'https:'].includes(parsed.protocol);
  } catch {
    return false;
  }
}

// Usage
const href = isSafeURL(userURL) ? userURL : '#';
```

## Context-Specific Encoding

Different contexts require different encoding approaches:

- **HTML Entity Encoding**: Safest option for text content
- **Attribute Encoding**: For HTML attributes
- **JavaScript Escaping**: For script contexts
- **URL Encoding**: For URL parameters
- **CSS Escaping**: For stylesheet contexts

Always encode output by the specific context where data will be rendered.

## Additional Implementations

See [references/python-sanitization.md](references/python-sanitization.md) for:
- Python bleach library usage
- Flask/Django template escaping
- Server-side validation patterns

See [references/nodejs-advanced.md](references/nodejs-advanced.md) for:
- Complete XSSPrevention class with all methods
- Express middleware (xssProtection)
- React components (SafeText, SafeHTML, SafeLink, useSanitizedInput)
- Helmet CSP configuration

## Best Practices

**✅ DO:**
- Encode output by default
- Use templating engines with auto-escaping
- Implement CSP headers
- Sanitize rich content with allowlists
- Validate URLs with protocol whitelisting
- Use HTTPOnly cookies
- Conduct regular security testing
- Leverage secure frameworks

**❌ DON'T:**
- Trust user input
- Use unsafe functions (eval, innerHTML)
- Disable security features for convenience
- Rely solely on client-side validation
- Use blocklists instead of allowlists
- Skip context-specific encoding
- Allow arbitrary script execution

## Security Checklist

- [ ] Encode all output by context (HTML, attribute, JS)
- [ ] Sanitize HTML with allowlist (not blocklist)
- [ ] Implement strict CSP headers
- [ ] Use HTTPOnly cookies for sessions
- [ ] Validate and sanitize URLs
- [ ] Avoid innerHTML with user content
- [ ] Regular security testing

## Resources

- [OWASP XSS Prevention Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Cross_Site_Scripting_Prevention_Cheat_Sheet.html)
- [DOMPurify Documentation](https://github.com/cure53/DOMPurify)
- [Content Security Policy Reference](https://content-security-policy.com/)
- [Web Security by Mozilla](https://developer.mozilla.org/en-US/docs/Web/Security)

© secondsky · MIT · secondsky/claude-skills

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

Все скиллы по теме «Безопасность» →
hunt-xss H-mmer Скилл hunt-xss для Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI и Windsurf, который обучает агента искать XSS-уязвимости: DOM-based, stored, reflected, mXSS и современные варианты. CX Codex +1 ★ 1 298звёзд репо xss-cross-site-scripting yaklang Скилл xss-cross-site-scripting для Claude Code разбирает сценарии XSS, когда пользовательские данные попадают в HTML, JavaScript или DOM. Он помогает выбрать контекст для анализа уязвимости. CX Codex +1 4 300установок scanning-for-xss-vulnerabilities Jeremy Longshore Скилл scanning-for-xss-vulnerabilities для Claude Code сканирует код на отражённый, сохранённый и DOM-based XSS. Проверяет формы, поиск и другие точки ввода. CX Codex +1 2установок testing-for-xss-vulnerabilities-with-burpsuite mahipal Скилл testing-for-xss-vulnerabilities-with-burpsuite ведёт агента по шагам поиска и подтверждения XSS в веб-приложении: от карты сайта до обхода CSP. Нужен на авторизованном пентесте. CX Codex +1 333установок xss-html-injection zebbern Скилл xss-html-injection структурирует проверку веб-приложений на XSS и внедрение HTML-кода через анализ отражённых, хранимых и DOM-уязвимостей. CX Codex +1 ★ 4 719звёзд репо csp-bypass-advanced yaklang Скилл csp-bypass-advanced для Claude Code, Codex, Cursor и ещё трёх платформ с техниками обхода Content Security Policy. CX Codex +1 4 000установок

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

Весь набор →
design-review Скилл design-review для Claude Code проверяет фронтенд-интерфейс по семи этапам: интерактивные состояния, адаптивность, визуальную полировку и соответствие WCAG 2.1 AA. CX Codex +1 327установок cloudflare-workers-ci-cd Скилл cloudflare-workers-ci-cd для Claude Code и других агентов: настраивает автотесты и деплой Cloudflare Workers через GitHub Actions или GitLab CI. Закрывает падающий пайплайн и выкатку превью на каждый PR. CX Codex +1 326установок cloudflare-workers-dev-experience Скилл cloudflare-workers-dev-experience помогает настроить локальную разработку Cloudflare Workers через Wrangler и Miniflare. Пригодится при отладке биндингов KV, D1 или R2 и настройке HMR. CX Codex +1 324установок cloudflare-workers-observability Скилл cloudflare-workers-observability для Claude Code: наблюдаемость Cloudflare Workers — структурированные логи, Analytics Engine, Tail Workers, метрики, алерты. Разбирает падение воркера в проде без видимых логов. CX Codex +1 322установок cloudflare-workers-multi-lang Скилл cloudflare-workers-multi-lang настраивает Cloudflare Workers на Rust, Python и WebAssembly. Помогает перенести вычисления в WASM и настроить сборку через wasm-pack. CX Codex +1 317установок cloudflare-r2 Работа с Cloudflare R2, S3-совместимым хранилищем объектов. Управляет бакетами, загрузками, CORS и подписанными ссылками. CX Codex +1 316установок cloudflare-workers-migration Скилл cloudflare-workers-migration для переноса приложений на Cloudflare Workers с AWS Lambda, Vercel, Express и Node.js. Автоматически адаптирует обработчики, middleware и переменные окружения под Web API. CX Codex +1 316установок tanstack-query Скилл помогает агенту работать с TanStack Query v5: получать данные, настраивать кэш, мутации и разбирать ошибки миграции с v4. CX Codex +1 314установок

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

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