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

Stuck — скилл для Claude Code: что делает и как установить

Скилл Stuck для Claude Code помогает агенту искать следующий способ решения, прежде чем объявлять задачу тупиковой. Он включается, когда агент зашёл в тупик или собирается просить помощи.

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

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

Что делает Stuck

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

Задать вопрос можно после этих шагов, если ответ зависит от решения пользователя, учётных данных или неоднозначного поведения, которое нельзя выяснить по коду. Остановка — последний шаг: в отчёте агент указывает место проблемы, уже испробованные подходы и то, что снимет блокировку. Для вопроса предусмотрена команда /envelope из соседнего скилла.

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

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

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

  • Я зашёл в тупик с этой ошибкой. Перебери следующие шаги, прежде чем просить помощи.
  • Не могу найти файл, на который ссылается код. Проверь возможные пути поиска и скажи, что пробовал.
  • В запросе есть неоднозначное решение. Определи, что можно выяснить по коду, а что нужно спросить у меня.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/stuck/SKILL.md

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

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

Вопросы о Stuck

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

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

Что делает Stuck?

Скилл задаёт порядок действий для агента, который столкнулся с ошибкой или не знает, как продолжить: от поиска альтернатив до конкретного вопроса или отчёта об остановке.

Когда Stuck разрешает агенту остановиться?

Остановка идёт последней, после попыток найти другой подход, рассмотреть альтернативы, обратиться к субагенту и перечитать запрос. Отчёт должен назвать место проблемы, предпринятые шаги и то, что поможет продолжить.

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

SKILL.md · MIT
---
name: Stuck
description: "Walk a six-rung escalation ladder before declaring stuck. Use when out of ideas, hitting a wall, or unsure what approach to try before asking for help."
---

# Stuck

Before posting "I'm blocked", "not sure how to proceed", or "should I…?" — walk this ladder. **Stopping is the last resort, not the first response.** Most obstacles aren't blockers; they're the next thing to try.

## When to use

- About to surface to the principal for help
- Hit an error, an obstacle, or genuine ambiguity
- Tempted to type "I'm stuck" or "this isn't working"
- Use on prompts like: "blocked", "not sure how", "can't find", "need help", "should I ask", "stuck on", "this isn't working", "hitting a wall", "give up", "ask for help"

## The ladder (climb top-to-bottom; only stop at the bottom)

### Rung 1 — Try a different approach
Most obstacles aren't blockers. Did you try plan A? Try plan B.
- API call failed → retry with different params, fallback to alternative API
- Test broken → fix the test
- Compile error → read the error and fix it
- Library doesn't do what you expected → try a different method on the same library

### Rung 2 — Try 2-3 alternatives explicitly
Brainstorm 3 ways to solve this. Note them down. Try each.
- Can the data come from a different source?
- Can the problem be solved at a different layer (UI vs API vs DB)?
- Is there a workaround that gets 80% of the value?

If you can't think of 3 alternatives, you haven't thought hard enough — keep listing.

### Rung 3 — Use a helper
Spawn an exploration subagent with a **specific question**.
- Not "help me figure this out" — that's a survey.
- "Find all callers of `generateHeadline` and report whether any pass `null` for the `archetypeId` argument" — that's a question.

### Rung 4 — Re-read the user's request
Sometimes the path is in the wording. The principal often gives the answer; you just read past it.
- Did they specify a constraint you've been violating?
- Did they reference a file or pattern you haven't checked?
- Did they say "like X" — and have you actually looked at X?

### Rung 5 — Genuinely ask
Only if rungs 1-4 have failed AND the missing information is **user-only** (a product decision, a credential, an ambiguous behavior with no code-side answer).

The ask must be:
- **One question** (not a survey)
- **Surgical** (X or Y with consequences spelled out — see [`/envelope`](../envelope/SKILL.md))
- **Stated** ("After trying A, B, and C, the remaining ambiguity is whether X means Y or Z. Y produces outcome P; Z produces outcome Q. Which?")

### Rung 6 — Stop and report
Rare. Reserved for truly nothing-else-to-try situations.

The stop report must include:
- **Where stuck** (specific file/line/system)
- **What I tried** (rungs 1-4 explicitly listed, with what each yielded)
- **What would unblock** (specific resource, decision, or access — be precise)

## Concrete examples

### Example A: API rate-limited mid-port (NOT stuck)
- **Wrong:** "I'm blocked — Replicate is rate-limiting me."
- **Right:** Wait + retry (rung 1). If sustained → switch to a fallback provider (rung 2). If no fallback → use the library's built-in throttling (rung 1). Don't surface unless 30+ minutes of throttling persist.

### Example B: Code references a file you can't find (NOT stuck)
- **Wrong:** "I can't find `lib/whatever.ts` — where is it?"
- **Right:** Grep for the symbol the file exports. Read import paths in nearby files. Check if it was renamed. Ask only if 4 different searches fail.

### Example C: Genuinely ambiguous product decision (STUCK at rung 5)
- **Right:** "After reading the spec, the codebase, and PR #341, I see two valid interpretations of 'cap at 50 minutes': hard truncate or graceful early-end. Hard truncate is 5 LOC; graceful needs a 30-line state machine. Which?" — then wait.

## The shorthand

> Most "stuck" is actually "haven't tried the next approach." Three rungs of effort beat one rung of asking.

## Output format when stuck-checking

If you're about to surface, first output (silently to yourself, then act):

```
[STUCK CHECK]
Rung 1 (alternatives tried): {list}
Rung 2 (alternative paths considered): {list}
Rung 3 (subagent helper used): {yes/no — what question}
Rung 4 (re-read request): {what new clue surfaced}
Verdict: {SHIP / ASK / STOP}
```

If verdict is SHIP — proceed with the work.
If verdict is ASK — use [`/envelope`](../envelope/SKILL.md) to format the question (Envelope B).
If verdict is STOP — write the stop report.

© wrg32786 · MIT · wrg32786/aigent-os

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
gke-ai-troubleshooting-tpu-slice-mig-stuck-updating официальный google Скилл gke-ai-troubleshooting-tpu-slice-mig-stuck-updating для Claude Code диагностирует сбои создания TPU Dynamic Slice и зависшие JobSet при нестабильной MIG в GKE. CX Codex +1 440установок gke-ai-troubleshooting-tpu-vm-repair-stuck официальный google Скилл gke-ai-troubleshooting-tpu-vm-repair-stuck для Claude Code диагностирует TPU VM в GKE, застрявшие в REPAIRING после ошибок хоста. Проверяет, почему TPU-срез нельзя запланировать из-за VM в ремонте. CX Codex +1 431установок writing-plans Jesse Vincent Скилл writing-plans для Claude Code и Codex создаёт детальный план реализации многошаговой задачи перед первой правкой кода. Запускается, когда у агента есть спецификация фичи или требования. CX Codex +1 282 859установок ketchup backnotprop Скилл ketchup пересказывает изменения в чате с момента последней реплики пользователя и собирает список решений, которые зависят только от человека. CX Codex +1 7 900установок gravitas udaysharmadev Скилл gravitas заставляет агента сначала читать код, потом менять, а готовым называть только то, что подтверждено выводом валидатора. CX Codex +1 6 800установок implement sentimony Скилл implement для Claude Code выполняет задачи из плана по порядку и сохраняет запись о ходе работы. Запускается для продолжения прерванного выполнения или небольших правок без плана. CX Codex +1 1 900установок

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

Весь набор →
frontend-slides Скилл frontend-slides для Claude Code создаёт анимированные HTML-презентации и конвертирует файлы PowerPoint в слайды для браузера. Запускается при подготовке доклада, питча или веб-версии PPT/PPTX. CX Codex +1 ★ 26звёзд репо sweep-links Скилл sweep-links для Claude Code находит битые вики-ссылки в заметках хранилища. Запускается по просьбе проверить ссылки или найти несуществующие заметки. CX Codex +1 ★ 26звёзд репо sweep-heat Скилл sweep-heat для Claude Code помечает холодные заметки в нижней двадцатке HEAT_INDEX.md как dormant. Запускается для проверки индекса и смены статуса заметок. CX Codex +1 ★ 26звёзд репо supersede Скилл supersede для Claude Code помечает устаревшие записи в заметках хранилища и добавляет датированную замену. Агент запускает его по просьбе обновить запись или заменить неверное утверждение. CX Codex +1 ★ 26звёзд репо status Скилл status для Claude Code показывает текущее состояние aigent-OS. Запускается по запросу о режиме работы, цели, следующем действии и блокерах. CX Codex +1 ★ 26звёзд репо start Скилл start для Claude Code показывает стартовый экран при первом запуске и возвращении к работе. Он задаёт вопросы для настройки или кратко описывает состояние дел и предлагает меню действий. CX Codex +1 ★ 26звёзд репо sprite-spec Скилл sprite-spec для Claude Code задаёт спецификацию пиксельного спрайта: палитру, пропорции и состояния анимации. Включается при проектировании персонажа или листа спрайтов. CX Codex +1 ★ 26звёзд репо solution-hunt Скилл solution-hunt для Claude Code ищет законные обходные пути, когда задача упирается в блокер. Он изучает локальные заметки и навыки, а затем ищет решения в GitHub и документации. CX Codex +1 ★ 26звёзд репо

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

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