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

Diagnose · wrg32786 — скилл для Claude Code: диагностика и установка

Скилл Diagnose для Claude Code, который ищет причину сбоев в настройках и компонентах aigent-OS. Разбирает проблемы с хуками, маршрутизацией скиллов и изменившимся поведением агента.

MIT ★ 26 обновлён 2026-11-16

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

Что делает Diagnose

Diagnose проходит по семи слоям aigent-OS: от конфигурации принципала и содержимого vault до скиллов, хуков и ядра. Сначала формулирует симптом, затем предлагает гипотезу и одну проверку для её подтверждения. Исправление рекомендует после проверки причины.

Когда причина подтверждена и исправление сработало, результат записывается в vault/memory/FAILURE_MODES.md; неподтверждённые гипотезы туда не попадают. Эта запись доступна в версии v0.2.2 и новее. Для проверки целостности установки скилл использует /system-check, а каталог скиллов разбирает через /skill-audit.

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

  • найти причину неработающего хука
  • разобраться, почему скилл не запускается
  • проверить, из-за чего /open собирает неполный контекст
  • определить, какой слой изменил поведение агента
  • зафиксировать подтверждённую причину сбоя

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

  • Разберись, почему хуки перестали срабатывать после обновления.
  • Найди причину, по которой нужный скилл не запускается на мои запросы.
  • Проверь, почему /open пропускает часть контекста.

Как установить Diagnose

1Через Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill diagnose -a claude-code

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

~/.claude/skills/diagnose/SKILL.md

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

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

Вопросы о Diagnose

Как установить Diagnose в Claude Code?

Выполни npx skills add wrg32786/aigent-os --skill diagnose -a claude-code. Файл скилла находится по пути ~/.claude/skills/diagnose/SKILL.md.

Что делает Diagnose?

Он ищет причину сбоя в семи слоях aigent-OS, формирует проверяемую гипотезу и предлагает конкретные шаги исправления после проверки.

Что происходит с результатом диагностики?

Подтверждённую причину и исправление скилл записывает в vault/memory/FAILURE_MODES.md. Неподтверждённые гипотезы не сохраняются.

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

SKILL.md · MIT
---
name: Diagnose
description: "Diagnose kernel, skills, hooks, daemons, vault, doctrine, and principal config. Use when hooks fail, routing breaks, or agent behavior changes."
---

# Diagnose

Most failures in an aigent-OS install aren't bugs in any single component — they're integration failures across layers. `/diagnose` walks the stack with you so you don't have to.

## When to use

- "It used to work, now it doesn't"
- A skill you expect is not being invoked
- `/open` produces incomplete context
- Hooks not firing
- Wikilinks not resolving
- AI behavior changed unexpectedly after an update
- Anything you can't immediately attribute to a single component

## How to execute

### Step 1 — Capture the symptom

Ask the user (or read from their prompt):
- **What were you trying to do?**
- **What happened instead?**
- **What did you expect?**
- **What changed recently?** (git pull, new skill installed, hook edit, kernel update)

Frame the symptom in one sentence. Example: *"/channel-audit used to run when I asked about YouTube performance, now it doesn't."*

### Step 2 — Walk the seven-layer stack

For each layer, ask: could this layer be responsible for the symptom? If yes, run the specific check. If no, move on.

```
LAYER 7 — Principal Configuration
   - system/00_identity.md customized?
   - system/14_decision_framework.md reflects current priorities?
   - vault/projects/ and vault/people/ populated?
   Check first if symptom involves AI giving wrong context or missing your situation.

LAYER 6 — Doctrine (vault/concepts/)
   - Has a relevant doctrine note been edited recently?
   - Are there standing rules that should be firing but aren't?
   Check if symptom is about AI behavior changing without you having edited the kernel.

LAYER 5 — Vault Content
   - Wikilinks resolve? (run /system-check Tier 4)
   - Heat index up to date?
   - Memory layer current?
   Check if symptom is "AI doesn't know about X" or "/open missed Y."

LAYER 4 — Daemons
   - Heat compute daemon ran recently?
   - Semantic search index fresh?
   Check if symptom is "skills not surfacing" or "search results stale."

LAYER 3 — Hooks
   - Settings.json wired?
   - Hook scripts executable?
   - Hook output going where you expect?
   Check if symptom is "automated behavior stopped."

LAYER 2 — Skills
   - skill-index.json valid?
   - Trigger keywords match the user's actual phrasing? (run /skill-audit Section 3)
   - Skill descriptions match what the skill does?
   - Skill visible at all? Run /context: a skill whose description was dropped by the listing budget cannot be matched.
   Check if symptom is "wrong skill firing" or "no skill firing."

LAYER 1 — Kernel
   - All 15 system docs present and unmodified?
   - CLAUDE.md loaded?
   - Authority matrix consistent with what you've authorized?
   Check last — kernel issues are rare but high-blast-radius.
```

### Step 3 — Form a hypothesis

State the most likely layer + the specific issue. Example:
*"Hypothesis: Layer 2 (Skills) — the trigger keywords for /channel-audit don't match the phrasing you've started using. /skill-audit Section 3 will confirm."*

### Step 4 — Verify with one targeted check

Run the specific check that confirms or refutes. Don't fix yet — verify the diagnosis first.

### Step 5 — Recommend a fix

Concrete steps. Not advice ("you should…") — commands ("run /skill-audit then add 'performance check' to .claude/skill-index.json line 47").

## Output format

```
🩺 aigent-OS Diagnose

SYMPTOM
   {one-sentence framing}

WHAT CHANGED RECENTLY
   {if known}

LAYER WALK
   ✅ L7 Principal Config — OK
   ✅ L6 Doctrine — OK
   ✅ L5 Vault — OK
   ✅ L4 Daemons — OK
   ✅ L3 Hooks — OK
   ⚠️ L2 Skills — POSSIBLE CAUSE
   ✅ L1 Kernel — OK

HYPOTHESIS
   Layer 2 (Skills): trigger keywords for /channel-audit drift from current
   phrasing. Confirmed by /skill-audit Section 3.

FIX
   1. Add "performance check" and "review channels" to /channel-audit's
      description ("Use when ...")
   2. Save and re-test the failing prompt
   3. If still broken, check the skill appears in /context (listing budget)
```

## Step 6 — Write the outcome to the failure modes corpus (v0.2.2+)

When the diagnosis is verified (the layer + symptom matched the actual cause and the fix worked), append to `vault/memory/FAILURE_MODES.md`:

```markdown
## YYYY-MM-DD — {short symptom name}

**Symptom (verbatim from principal):** "{their own words}"
**Layer responsible:** L{N} ({layer name})
**Specific cause:** {file/line/config that was the actual issue}
**Fix applied:** {what the principal or agent did}
**Time to diagnose:** {minutes from /diagnose start to verified cause}
**Pattern (one line):** {what category of failure this was}
```

Why: a single failure is data; recurring failures are doctrine. The corpus enables Phase 2 promotion of patterns that occur 3+ times to [[Common Failure Modes]] permanent doctrine. Without the corpus, the framework can't harden against the failures it's actually had.

Skip this step if the diagnosis didn't verify — only confirmed causes get written. Hypotheses that didn't pan out aren't useful corpus data.

## Why this skill exists

Without `/diagnose`, a user with a broken install has to either dive into the source or give up. The seven-layer model gives them a structured path through the stack — even if they don't fix it themselves, they end up with a precise enough diagnosis to file a useful issue or ask a useful question.

Over time, the corpus this skill builds turns one-off diagnostics into framework hardening — the failure modes the framework has actually hit become the failure modes future principals can recognize in 30 seconds instead of 30 minutes.

## Anti-patterns this prevents

- "Something's broken" → maintainer asks 5 follow-up questions to figure out what
- User fixes the wrong layer (e.g., editing the kernel when the skill was the issue)
- Frustration from intermittent failures with no obvious cause
- Issues filed without enough information to action

## Connects to

- [`/system-check`](../system-check/SKILL.md) — verifies install integrity
- [`/skill-audit`](../skill-audit/SKILL.md) — checks skill catalog hygiene (Layer 2 deep-dive)

© wrg32786 · MIT · wrg32786/aigent-os

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

Каталог скиллов SKILL.md →

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

diagnose официальный github Скилл diagnose для GitHub Copilot проверяет AI-workflow по пяти измерениям и выдаёт оценки с приоритетными действиями. Проводит аудит агента перед запуском и после заметных изменений. CX Codex +1 209установок diagnose getagentseal Скилл diagnose для Claude Code помогает основателю понять, что сломалось, и выбрать один фреймворк вместо перебора наугад. CX Codex +1 811установок diagnose LegendApp Скилл diagnose для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — запускает структурированное расследование бага по явному вызову. CX Codex +1 429установок diagnose pedrohcgs Скилл diagnose для Claude Code ведёт от воспроизведения бага к минимальному примеру, гипотезам и починке. Разбирает регрессии с неверным числом и падения скриптов. CX Codex +1 ★ 1 729звёзд репо azure-resource-health-diagnose официальный github Скилл azure-resource-health-diagnose для GitHub Copilot проверяет состояние ресурса Azure, анализирует логи и телеметрию и составляет план исправлений для диагностики конкретного ресурса. CX Codex +1 8 700установок diagnose-seo calm-north Скилл diagnose-seo для Claude Code проводит технический SEO-аудит: проверяет сканирование, индексацию, robots.txt, canonical и рендеринг JavaScript. CX Codex +1 2 200установок diagnose-fix-loop LegendApp Скилл diagnose-fix-loop ведёт агента по кругу: диагноз, точечная правка, проверка тем же сигналом и снова диагноз. Пока не найдётся причина, а не симптом. CX Codex +1 426установок alibabacloud-elasticsearch-instance-diagnose aliyun Скилл alibabacloud-elasticsearch-instance-diagnose для анализа здоровья кластера Elasticsearch на Alibaba Cloud. Собирает данные из OpenAPI и REST API, выявляет корневые причины проблем и предлагает пути решения. CX Codex +1 127установок opik-diagnose comet-ml Скилл opik-diagnose для Claude Code, который ранжирует трассировки Opik по сигналам проблем. Запускается для поиска ошибок, медленных вызовов и сбоев в продакшене. CX Codex +1 111установок aws-resource-health-diagnose официальный github Скилл aws-resource-health-diagnose проверяет состояние ресурсов AWS, анализирует логи и метрики CloudWatch, а затем составляет пошаговый план устранения сбоев. CX Codex +1 40установок

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

Весь набор →
find-weakness Скилл find-weakness для Claude Code и Codex находит главное возражение и самую рискованную скрытую предпосылку в архитектурном решении или отдельном утверждении. CX Codex +1 ★ 26звёзд репо Envelope Скилл Envelope для Claude Code распределяет запросы по трём вариантам: выполнить, задать один вопрос или сначала предложить план. Он включается, когда агент решает, действовать ли без уточнений. CX Codex +1 ★ 26звёзд репо dream Скилл dream для Claude Code обобщает наблюдения из сессий и предлагает улучшения. Запускается для разбора недавней работы, заметок и повторяющихся сбоев. CX Codex +1 ★ 26звёзд репо digest Скилл digest для Claude Code разбирает отложенные кандидаты памяти из MEMORY_CANDIDATES.md. Он предлагает решить по каждому: перенести, пропустить или заменить существующую запись. CX Codex +1 ★ 26звёзд репо deep-recon Скилл deep-recon для Claude Code запускает разведку темы несколькими субагентами и собирает структурированный документ. Можно исследовать заметки и веб-источники в интерактивном или автономном режиме. CX Codex +1 ★ 26звёзд репо decide Разбирает решение через набор критериев и выдаёт структурированную рекомендацию. Запускается командой /decide, когда нужно сравнить варианты или выбрать следующий шаг. CX Codex +1 ★ 26звёзд репо critique-plan Скилл critique-plan для Claude Code разбирает стратегические планы, архитектурные решения и предложения до того, как их утвердят. Агент ищет слабые места, скрытые допущения и альтернативы. CX Codex +1 ★ 26звёзд репо context-hygiene Архивирует старые записи журнала сессий и очищает список активных приоритетов. Запускается по команде /context-hygiene или запросу о чистке контекста. CX Codex +1 ★ 26звёзд репо

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

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