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

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

Скилл First 10 Moves для Claude Code помогает освоиться в незнакомом репозитории и найти место, связанное с задачей. Включается при поиске бага, исследовании кода или подготовке правки.

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

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

Что делает First 10 Moves

First 10 Moves задаёт порядок исследования кода до первой правки: изучить запрос и структуру проекта, прочитать манифест и README, найти ключевые слова, затем проследить путь от точки входа до вызывающего кода. Сначала агент читает публичные импорты и экспорты, потом разбирает одну точку вызова и функцию, связанную с симптомом.

Дальше скилл предлагает проверить данные или логи и подтвердить гипотезу точечным чтением либо запросом. До этого этапа код не меняют и не запускают. В завершение агент выводит путь к модулю, точку входа, гипотезу, способ её проверки и план минимальной правки. Если причина не подтвердилась, исследование возвращается к функции с новой гипотезой.

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

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

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

  • Исследуй незнакомый репозиторий и найди, где определяется генератор заголовков.
  • Проследи этот баг от точки входа до функции, которая его вызывает.
  • Разберись, почему заголовки повторяются, и сначала проверь гипотезу без правок.

Как установить First 10 Moves

1Через Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill first-10-moves -a claude-code

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

~/.claude/skills/first-10-moves/SKILL.md

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

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

Вопросы о First 10 Moves

Как установить First 10 Moves в Claude Code?

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

Что делает First 10 Moves?

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

Когда First 10 Moves подключается к задаче?

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

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

SKILL.md · MIT
---
name: First 10 Moves
description: "Read and explore unfamiliar code before asking questions. Use when new to a repo, orienting in an unfamiliar codebase, or finding where to start."
---

# First 10 Moves

When dropped into an unfamiliar codebase or asked to fix something in code you don't know — run this sequence before doing anything else. The principle: **most "clarification" questions are answered by 5 minutes in the relevant file.** If the answer is in the code, the docs, or the file tree — find it there before asking.

## When to use

- Fresh in an unfamiliar codebase
- Asked to fix or change code in an area you haven't worked in
- Tempted to ask "where does X live?" or "how does Y work?"
- Use on prompts like: "fix the X", "investigate", "trace this bug", "how does X work", "unfamiliar codebase", "where is X defined", "what calls Y", "navigate the code", "find the bug in"

## The sequence (run top-to-bottom)

### 1. Re-read the user's request
Look for clues. "Fix" implies a bug. "The headline generator" implies a named module. Note any screenshots, errors, or examples included. **The exact phrasing embeds most of the diagnosis** — don't abstract it away.

### 2. Get the lay of the land (~30 seconds)
- List project root
- Identify main source directory
- Read `package.json` / `pyproject.toml` / `Cargo.toml` (whatever the manifest is)
- Read README if short

This rules out a lot. You learn the language, framework, build system, and entry point in 30 seconds.

### 3. Search for the keyword across the project
One ripgrep, filtered to relevant extensions. The matches will cluster around the real module.

### 4. Pick the most likely 2-3 matched files
**Filenames are huge signal.** `aiHeadlineGenerator.ts` beats `headlineUtils.test.ts`. Production code beats test code. Implementation beats type definitions.

### 5. Read the public surface of the top candidate
**Imports + exports, not bodies.** Shape first. What does this module take in and put out? What does it depend on?

### 6. Find the entry point — who calls this?
Search for the main exported function name. Call sites tell you how the module fits into the larger pipeline.

### 7. Read one upstream call site fully
Concrete example of "what inputs does this receive in real use?" That constrains everything downstream. Don't read 5 call sites — one is usually enough.

### 8. Read the main function body, focused on the symptom
- **Specific symptom** ("headlines are repeating") → find the path that produces it (the loop, the dedup logic, the source list)
- **General "fix it"** → top-to-bottom, alert for obvious issues (off-by-one, null guards, stale comparators, hardcoded values)

### 9. Query the data the function works with
A few DB rows, the actual config file, the recent log lines. **Reality often disagrees with code's assumptions.** This catches it fast.

### 10. Form a hypothesis, verify with one targeted read or query
"I think X because Y, confirm by checking Z."
- Confirmed → fix.
- Not confirmed → loop back to step 8 with the new hypothesis.

**Hit rate at step 10: ~80% land a correct hypothesis.** The remaining 20% loop back with what was learned.

## What NOT to do in the first 10 moves

- ❌ Read every file in the directory
- ❌ Read tests before reading the code under test
- ❌ Ask a clarifying question (unless genuinely too vague)
- ❌ Start writing fix code (first fix attempt comes AFTER move 10)
- ❌ Run the code to "see what happens" — understand it statically first
- ❌ Open the IDE outline / class hierarchy explorer — too noisy
- ❌ Ask the user "where is X defined?" — grep is faster than asking

## Most of the work is reading, not writing

A typical non-trivial change is **~80% reading, 20% writing.** The edit is the *result* of the engineering, not the engineering itself. Agents that flip this ratio produce code that doesn't fit the surrounding system.

## Output format

When you complete the recon, before writing any fix code, output:

```
**Recon complete:**
- Module: {path/to/file.ts}
- Entry point: {function name + caller path}
- Hypothesis: {what I think is wrong, in plain English}
- Verified by: {what I read/queried that confirms the hypothesis}
- Plan: {smallest change that solves it}
```

Then execute the fix.

© wrg32786 · MIT · wrg32786/aigent-os

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
repo-skillopt objectivlabs Скилл repo-skillopt для Claude Code разбирает устройство репозитория и собирает спецификацию с опорой на файлы, конфиги и тесты. Активируется при просьбах объяснить кодовую базу, описать архитектуру, внести изменения или оценить риски. CX Codex +1 598установок ai-bug-triage kindlmann Скилл ai-bug-triage выстраивает гибридный пайплайн триажа багов: нормализует логи CI, дедуплицирует ошибки по отпечаткам и поручает модели оценку критичности и составление тикетов. CX Codex +1 1 700установок bmad-investigate aj-geddes Скилл bmad-investigate для Claude Code расследует баги и оформляет факты в case file. Запускается по запросу найти причину ошибки, разобрать инцидент или обновить расследование. CX Codex +1 102установок btca-local davis7dotsh Скилл btca-local для Claude Code ищет ответы в локальных Git-репозиториях и помогает агенту ссылаться на найденный код. Читает исходники проектов на этой машине. CX Codex +1 1 000установок principle-redesign-from-first-principles backnotprop Скилл principle-redesign-from-first-principles для Claude Code и Codex: перестраивает дизайн под новое требование так, будто оно было с самого начала. Затрагивает несколько файлов и связей. CX Codex +1 10 200установок thinking-first-principles tjboudreaux Скилл thinking-first-principles для Claude Code отделяет реальные ограничения от привычек и перестраивает решение с нуля. Запускается, если задачу останавливает «так не делается» без доказательств. CX Codex +1 844установок

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

Весь набор →
impeccable Скилл impeccable для Claude Code помогает создавать страницы и приложения, задавать стиль интерфейса и выделять компоненты с дизайн-токенами. Перед работой ему нужен контекст о пользователях, задачах и характере бренда. CX Codex +1 ★ 26звёзд репо humanize-docs Скилл humanize-docs для Claude Code переписывает шаблонную документацию от нейросетей в связный текст. Устраняет избыточные чекбоксы и монотонную структуру разделов. CX Codex +1 ★ 26звёзд репо Honesty Check Скилл Honesty Check для Claude Code собирает сведения о выполненной работе в журнал честности. Он включается перед сообщением о готовности задачи или передавая работу на ревью. CX Codex +1 ★ 26звёзд репо first-win Предлагает три стартовые задачи с готовым результатом. Вызовите /first-win, чтобы превратить пост в публикации, идею — в план или письма — в список приоритетов. CX Codex +1 ★ 26звёзд репо 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звёзд репо

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

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