Stuck — скилл для Claude Code: что делает и как установить
Скилл Stuck для Claude Code помогает агенту искать следующий способ решения, прежде чем объявлять задачу тупиковой. Он включается, когда агент зашёл в тупик или собирается просить помощи.
MIT ★ 26 обновлён 2026-11-16
npx skills add wrg32786/aigent-os --skill stuck -a claude-codeЧто делает Stuck
Stuck проводит агента по лестнице из шести шагов, прежде чем тот остановится или задаст вопрос. Сначала нужно попробовать другой подход и перечислить альтернативы, затем обратиться к субагенту с конкретным вопросом и перечитать запрос пользователя.
Задать вопрос можно после этих шагов, если ответ зависит от решения пользователя, учётных данных или неоднозначного поведения, которое нельзя выяснить по коду. Остановка — последний шаг: в отчёте агент указывает место проблемы, уже испробованные подходы и то, что снимет блокировку. Для вопроса предусмотрена команда /envelope из соседнего скилла.
Какие задачи решает
- найти другой способ обойти ошибку
- сравнить несколько путей решения задачи
- проверить, не пропустил ли агент условие в запросе
- сформулировать точный вопрос по неясному решению
- составить отчёт о блокировке и нужных ресурсах
Примеры запросов агенту
- Я зашёл в тупик с этой ошибкой. Перебери следующие шаги, прежде чем просить помощи.
- Не могу найти файл, на который ссылается код. Проверь возможные пути поиска и скажи, что пробовал.
- В запросе есть неоднозначное решение. Определи, что можно выяснить по коду, а что нужно спросить у меня.
Как установить Stuck
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill stuck -a claude-code2Вручную: положить файлы
~/.claude/skills/stuck/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/stuck/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill stuck -a codex2Вручную: положить файлы
.agents/skills/stuck/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill stuck -a cursor2Вручную: положить файлы
.cursor/skills/stuck/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wrg32786/aigent-os skills/stuck2Вручную: положить файлы
.github/skills/stuck/SKILL.md1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill stuck -a gemini-cli2Командой платформы
gemini skills install https://github.com/wrg32786/aigent-os --path skills/stuckВручную: положить файлы
.devin/skills/stuck/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill stuck -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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