# pit-of-success

Скилл pit-of-success находит скрытые ловушки в коде и перестраивает интерфейсы так, чтобы очевидный вызов разработчика автоматически соблюдал все инварианты.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 137 установок · ★ 107 у репозитория
- Автор: jnsahaj
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jnsahaj/skills/tree/HEAD/skills/pit-of-success/SKILL.md
- Обновлён: 2026-10-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/pit-of-success

## Что делает

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

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

Инструкция запрещает закрывать проблему комментариями с просьбой помнить о хелперах, пока открыт небезопасный метод.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill pit-of-success -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/pit-of-success/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/pit-of-success/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill pit-of-success -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/pit-of-success/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill pit-of-success -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/pit-of-success/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jnsahaj/skills skills/pit-of-success
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/pit-of-success/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill pit-of-success -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/jnsahaj/skills --path skills/pit-of-success
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/pit-of-success/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill pit-of-success -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/jnsahaj/skills/tree/HEAD/skills/pit-of-success/SKILL.md

## Когда брать
- устранить скрытые ловушки в публичных интерфейсах и API
- сузить типы и схемы для защиты от некорректных состояний
- удалить лишние обёртки вокруг сырых методов
- перестроить методы так, чтобы безопасное поведение стало стандартным

## Примеры запросов агенту
- Проверь этот хук на скрытые ловушки по принципу pit-of-success
- Перепиши сеттеры состояния компонента, чтобы некорректные вызовы отсекались на уровне типов

## Похожие
- [dx-review](https://affpapa.org/nevibecode/skills/dx-review.md) — скилл · 1 установка
- [public-api-design-review](https://affpapa.org/nevibecode/skills/public-api-design-review.md) — скилл · 10200 установок
- [swift-api-design-guidelines](https://affpapa.org/nevibecode/skills/swift-api-design-guidelines.md) — скилл · 3100 установок
- [kotlin-api-design](https://affpapa.org/nevibecode/skills/kotlin-api-design.md) — скилл · 1300 установок
- [swift-api-design-guidelines-skill](https://affpapa.org/nevibecode/skills/swift-api-design-guidelines-skill.md) — скилл · 1200 установок
- [api-design](https://affpapa.org/nevibecode/skills/margelo-api-design.md) — скилл · 1400 установок

Из того же набора: [jnsahaj/skills](https://affpapa.org/nevibecode/by/jnsahaj/skills.md) — 6 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
