ns-best-practices — скилл для Claude Code: что делает и как установить
Скилл ns-best-practices проверяет заголовки безопасности, базовую доступность интерфейса и правила Web Interface Guidelines. Находит уязвимости и готовит отчёт.
Apache-2.0 154 установок обновлён 2026-10-24
npx skills add nextstage-brasil/skills --skill ns-best-practices -a claude-codeЧто делает ns-best-practices
Скилл проводит гигиенический аудит безопасности и интерфейса. Он проверяет конфигурации веб-серверов и фреймворков вроде Nginx, Vite, Next.js или Laravel. Проверка затрагивает заголовки CSP, CORS, HSTS и базу известных CVE, а также базовую доступность разметки: ориентиры, метки и alt-атрибуты.
Процесс устроен пошагово. Скилл сверяется с локальным чек-листом references/checklist.md, прогоняет аудит по встроенным правилам Vercel Web Interface Guidelines и формирует таблицу замечаний. В отчёте указывает критичность, путь файл:строка, совет по исправлению и оценку трудозатрат. По умолчанию агент только показывает отчёт; безопасные правки вносит, только если пользователь попросил об этом явно.
Для работы скилла требуется ns-harness. Он не заменяет моделирование угроз для критичных сервисов: регламент скилла требует передавать оценку таких рисков человеку.
Какие задачи решает
- настроить защитные HTTP-заголовки, CSP и HSTS в конфигах
- проверить разметку интерфейса на базовую доступность и ARIA-метки
- провести аудит зависимостей на известные CVE
- сверить веб-интерфейс с правилами Vercel Web Interface Guidelines
Примеры запросов агенту
- Проверь заголовки безопасности и CSP в конфигурации Vite и Nginx
- Проведи аудит доступности интерфейса и расставь alt-атрибуты с метками
- Сверь прототип с Web Interface Guidelines и подготовь таблицу замечаний
Как установить ns-best-practices
1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-best-practices -a claude-code2Вручную: положить файлы
~/.claude/skills/ns-best-practices/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ns-best-practices/
1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-best-practices -a codex2Вручную: положить файлы
.agents/skills/ns-best-practices/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-best-practices -a cursor2Вручную: положить файлы
.cursor/skills/ns-best-practices/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install nextstage-brasil/skills skills/ns-best-practices2Вручную: положить файлы
.github/skills/ns-best-practices/SKILL.md1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-best-practices -a gemini-cli2Командой платформы
gemini skills install https://github.com/nextstage-brasil/skills --path skills/ns-best-practicesВручную: положить файлы
.devin/skills/ns-best-practices/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-best-practices -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ns-best-practices
Как установить ns-best-practices в Claude Code?
Выполните команду npx skills add nextstage-brasil/skills --skill ns-best-practices -a claude-code. Скилл загрузится в ~/.claude/skills/ns-best-practices/SKILL.md.
Что проверяет ns-best-practices?
Скилл ищет недочёты в HTTP-заголовках, проверяет зависимости на уязвимости, оценивает базовую доступность HTML и сверяет компоненты с Web Interface Guidelines.
Заменяет ли скилл полноценный аудит безопасности?
Нет. Правила скилла запрещают объявлять систему защищённой без прямых доказательств, а моделирование угроз в критичных сервисах предписано передавать человеку.
Исходный текст
SKILL.md · Apache-2.0
--- name: ns-best-practices description: "(NS) Security/compat/a11y + Vercel Web Interface Guidelines. Use when hardening security, fixing CSP/CORS/headers, reviewing UI / checking a11y / auditing UX, or Web Interface Guidelines — even without saying \"best practices\"; also ns-proto-creator close-out. Do NOT use for MR/SOLID (ns-reviewer), visual redesign (ns-frontend-design), or features (ns-coder / ns-spec-driven)." license: Apache-2.0 metadata: author: nextstage-brasil version: "1.1" depends: - ns-harness --- # Best Practices Focused **quality + security hygiene** pass — not substitute for senior code review or visual design direction. ## Session boot See `../ns-harness/references/session-boot.md`. Read `architecture-rules.md` + security-related harness rules. ## When to use | Request | This skill | Use instead | | ------- | ---------- | ----------- | | Security headers / CSP / HSTS | Yes | — | | Dependency audit / known CVE sweep | Yes | — | | Browser compatibility baseline | Yes | — | | Accessibility quick pass (landmarks, alt, labels) | Yes | — | | "Review my UI" / Web Interface Guidelines / UX a11y audit | Yes (`references/ui-guidelines-review.md`) | — | | Distinctive visual redesign / anti-slop aesthetics | No | `ns-frontend-design` | | "Review this MR" / SOLID deep dive | No | `ns-reviewer` | | New feature implementation | No | `ns-coder` / `ns-spec-driven` | ## Workflow 1. **Scope** — web app surface, API gateway, static assets, or `prototype/`. 2. **Baseline** — read `references/checklist.md`; tick only applicable sections (offline security/compat/a11y). 3. **Guidelines** — UI/a11y/UX audit **or** invoker is `ns-proto-creator` close-out: read `references/ui-guidelines-review.md` fully (bundled rules; no external fetch). 4. **Scan** — configs (nginx, Vite, Next, Laravel middleware, etc.); no stack assume. 5. **Report** — findings table: severity, location (`file:line` when possible), recommendation, effort. 6. **Fix** — minimal safe diffs when user asked implement; else report only. ## Overlap with other skills - **This skill:** cross-cutting hygiene + Web Interface Guidelines compliance. - **ns-frontend-design:** distinctive look, typography, motion, anti–generic AI UI. - **ns-reviewer:** change-specific SOLID, tests, maintainability on diff. Delivery may use sequentially — face skills route explicit. ## Forbidden - Declare production secure without evidence - Break existing integrations without calling out risk - Replace threat modeling for high-risk domains (escalate to human) - Skip `references/ui-guidelines-review.md` on UI audit / proto close-out and claim full UI pass
© nextstage-brasil · Apache-2.0 · nextstage-brasil/skills