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

kodeblue-self-integrity — скилл для Claude Code: установка и суть

Скилл kodeblue-self-integrity для Claude Code расследует изменения бинарников, движка и конфигов kodeblue. Проверяет возможное вмешательство злоумышленника при остановке или модификации агента.

Apache-2.0 ★ 71 обновлён 2026-11-15

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

Что делает kodeblue-self-integrity

Скилл анализирует оповещения об изменении бинарников /usr/local/bin/kodeblue, движка в /usr/local/lib/kodeblue/engine или конфигурации в каталоге /etc/kodeblue. Легитимные обновления через install.sh открывают десятиминутное окно обслуживания, поэтому плановая замена файлов попадает в журнал и не вызывает тревогу. Любая правка вне этого окна расценивается как возможное вмешательство.

Для расследования агент сверяет владельца и права доступа (root, 0755), вычисляет SHA-256 через host_exec, смотрит процессы kodeblue run и kodeblue mcp, а также журналы авторизации и активность sudo. Изменения во время активных атак получают наивысшую строгость.

Агент никогда не помечает такие находки как безопасные самостоятельно. Он выставляет статус inconclusive и запрашивает подтверждение оператора через команду kodeblue ack <finding id>.

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

  • расследовать изменения бинарников и конфигурации kodeblue
  • проверить контрольные суммы SHA-256 и права файлов kodeblue
  • отличить штатный апгрейд в окне обслуживания от ручной правки
  • подтвердить инцидент целостности командой kodeblue ack

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

  • Проверь оповещение об изменении бинарника kodeblue
  • Выясни, почему kodeblue останавливался во время инцидента
  • Сверь хеш /usr/local/bin/kodeblue с журналом целостности

Как установить kodeblue-self-integrity

1Через Skills CLI (Vercel)

npx skills add Problem99-io/kodeblue --skill kodeblue-self-integrity -a claude-code

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

~/.claude/skills/kodeblue-self-integrity/SKILL.md

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

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

Вопросы о kodeblue-self-integrity

Как установить kodeblue-self-integrity в Claude Code?

Выполните команду npx skills add Problem99-io/kodeblue --skill kodeblue-self-integrity -a claude-code.

Что делает kodeblue-self-integrity?

Скилл проверяет модификации компонентов kodeblue, сравнивает хеши и права доступа к файлам и не даёт агенту закрывать инциденты целостности без оператора.

Почему скилл не закрывает инцидент целостности автоматически?

Любое вмешательство в защитный агент может быть попыткой злоумышленника отключить наблюдение. Скилл ставит статус inconclusive, пока оператор не подтвердит изменение командой kodeblue ack <finding id>.

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

SKILL.md · Apache-2.0
---
name: kodeblue-self-integrity
description: Findings about kodeblue itself — its binaries, engine, config or state changing, or kodeblue having stopped — and why they are never benign without an operator.
metadata:
  kodeblue-bundled: true
---

# kodeblue's own integrity

An attacker who controls the machine wants to blind or tamper with its
watcher. A change to kodeblue itself is therefore treated as tampering until an
operator confirms it.

## What a legitimate change looks like
- **Upgrades** through `install.sh` (a hub-driven upgrade or an operator
  re-running the installer) open a journaled 10-minute maintenance window first,
  so swapping kodeblue's binaries inside it is absorbed and does not alert.
  `stats` shows the recent journal. A finding on kodeblue's binaries usually means
  the change happened **outside** such a window: a manual copy, a build pushed by
  hand, or someone else.
- **Config** in `/etc/kodeblue` is root-owned; a change there is an operator's
  action or a root compromise.

## Check
1. `host_exec ["stat","/usr/local/bin/kodeblue"]` (and
   `/usr/local/lib/kodeblue/engine`): owner, mode, change time. Owner and mode
   must match the install (root, 0755).
2. `host_exec ["sha256sum","/usr/local/bin/kodeblue"]`: the integrity collector
   records the same SHA-256 (findings may show it shortened), so you can match the
   finding's old and new values.
3. `ps -eo pid,user,lstart,cmd`: the agent restarted shortly after the change
   and runs cleanly (`kodeblue run`, `kodeblue mcp`, the engine). Old instances may
   linger as zombies for a moment.
4. Who could have written it: logins and sudo around the change time
   (`last`, the auth log), and other files changed then
   (`find /etc /root /home /tmp /var/tmp /usr/local -newermt <time> -type f`).
5. Attack context: was an attacker active (request log, open incidents) near the
   change time? A change during an active attack keeps high severity until an
   operator confirms it.

Notes:
- The integrity baseline keeps the old hash until a finding is resolved, so a
  second change the same day reports against the original value. Line the values
  up before concluding there was only one change.
- A finding on kodeblue's binaries that is still open, waiting for an operator or
  resolved `inconclusive` keeps those paths out of maintenance absorption: until
  the operator acks it, every later upgrade alerts again. Say so when you ask for
  the ack, and check for such an older finding when an upgrade alerted.
- `kodeblue upgrade` itself runs as root from the binary its installer replaces
  (in the `kodeblue-upgrade.service` unit), which kodeblue recognises and
  journals as `absorb.upgrade` instead of reporting a deleted executable.
- A gap finding ("kodeblue was not running for …") is the same question: was it
  a planned restart or upgrade, or did something stop it?

## Verdict
Never `benign_change` on your own judgement, even when the pattern looks exactly
like an upgrade. Resolve `inconclusive`, send an alert asking whether someone deployed a
build at that time, and let the operator acknowledge it with
`kodeblue ack <finding id>`.
Without that answer, treat a change during attacker activity as a true_positive.

© Problem99-io · Apache-2.0 · Problem99-io/kodeblue

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

Все скиллы по теме «Безопасность» →
hermes-attestation-guardian prompt-security Скилл hermes-attestation-guardian для проверки целостности Hermes-инфраструктуры в runtime. Генерирует подписанные аттестации, сравнивает их с базовыми версиями и отслеживает отклонения конфигурации. CX Codex +1 129установок soul-guardian prompt-security Скилл soul-guardian для Claude Code отслеживает изменения в рабочих файлах агента, восстанавливает защищённые версии и отправляет предупреждения. Контролирует целостность workspace. CX Codex +1 258установок audit-integrity официальный github Скилл audit-integrity проверяет доказательства уязвимостей, запрещает замалчивать находки и оценивает отчёт по шкале качества от 8 из 10. Пригодится при SAST, SCA и аудите кода. CX Codex +1 202установок Security Monitoring Claude Office Skills Скилл Security Monitoring для автоматизации мониторинга безопасности: правила детекта, алерты, разбор инцидентов и проверки на соответствие требованиям. CX Codex +1 4 800установок incident-response Alireza Rezvani Скилл incident-response классифицирует сработавшую тревогу по 14 типам инцидентов, отсеивает ложные и подсказывает, кого звать и что фиксировать. CX Codex +1 634установок dd-audit-key-compromise datadog-labs Скилл dd-audit-key-compromise для Claude Code разбирает Datadog Audit Trail по подозрительному API-ключу: хронология, география запросов, вызванные эндпоинты, удалённые ресурсы. CX Codex +1 559установок

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

Весь набор →
containment-verification Скилл containment-verification для Claude Code проверяет на хосте результат защитных действий kodeblue после блокировки IP, завершения процессов, изоляции файлов или остановки служб. CX Codex +1 ★ 71звёзд репо linux-intrusion-triage Скилл linux-intrusion-triage для Claude Code помогает проверить Linux-хост, который мог быть скомпрометирован. Он задаёт порядок первичной проверки и использует инструменты kodeblue только для чтения. CX Codex +1 ★ 71звёзд репо false-positive-playbook Скилл false-positive-playbook для Claude Code помогает агенту доказывать безопасность алертов системы kodeblue. Он отделяет легитимные изменения от атак по системным логам. CX Codex +1 ★ 71звёзд репо web-app-attack-chain Скилл web-app-attack-chain для Claude Code восстанавливает цепочку атаки по журналам запросов. Он выделяет успешные действия внутри приложения и перечисляет, что должен отменить человек. CX Codex +1 ★ 71звёзд репо service-restart-forensics Скилл service-restart-forensics для Claude Code расследует остановки и перезапуски сервиса. Он проверяет новый процесс и помогает определить, когда причину нельзя найти на этом хосте. CX Codex +1 ★ 71звёзд репо outbound-destination-check Скилл outbound-destination-check для Claude Code проверяет внешние сетевые соединения процессов и отличает штатный служебный трафик вендоров от активности вредоносного ПО. CX Codex +1 ★ 71звёзд репо service-process-exploitation Скилл service-process-exploitation для Claude Code помогает искать выполнение кода внутри процесса легитимного сервиса. Он разбирает дочерние процессы, исходящие соединения и изменения файлов. CX Codex +1 ★ 71звёзд репо container-breakout-detection Скилл container-breakout-detection для Claude Code определяет побег процессов из контейнера на хост. Проверяет конфигурации рантайма и аномалии в пространствах имён хоста. CX Codex +1 ★ 71звёзд репо

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

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