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

research-question — скилл для Claude Code: вопросы для исследования

Скилл research-question превращает расплывчатую тему в исследовательские вопросы и оценивает их по рубрике. Пригодится на этапе выбора того, что именно изучать.

MIT ★ 185 обновлён 2026-06-30

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gaasher/Agent-Loop-Skills
/plugin install agent-loops@agent-loop-skills
Открыть на GitHub

Что делает research-question

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

Для проверки новизны нужен доступ к поиску в научной литературе или в вебе. Без такой проверки оценка новизны остаётся непроверенной. Перед работой скилл настраивает параметры исследования и сохраняет их в loop.run.yaml; для Claude Code также требуется Python 3.9+. Он помогает сформулировать вопросы, но не оценивает готовую заявку и не превращает вопросы в гипотезы.

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

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

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

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

Как установить research-question

1Через маркетплейс плагинов

/plugin marketplace add gaasher/Agent-Loop-Skills
/plugin install agent-loops@agent-loop-skills

Команда ставит плагин agent-loops целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add gaasher/Agent-Loop-Skills --skill research-question -a claude-code

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

~/.claude/skills/research-question/SKILL.md

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

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

Вопросы о research-question

Как установить research-question в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add gaasher/Agent-Loop-Skills, затем установите плагин командой /plugin install agent-loops@agent-loop-skills.

Что делает research-question?

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

Что нужно для проверки новизны?

Нужен доступ к поиску по научной литературе или вебу. Если проверку новизны отключить, оценка остаётся непроверенной.

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

SKILL.md · MIT
---
name: research-question
description: >
  Use when the user has a vague topic or area of interest and wants it sharpened into a few strong,
  novel, feasible research questions. Drafts candidate questions, scores each against a fixed rubric
  (Specific, Answerable, Novel, Feasible, Significant) with a light literature/web novelty check, and
  revises the weakest axis until enough questions clear the bar. Not for grading a full written
  proposal (use the research-proposal loop), and not for turning a question into testable predictions
  (use the hypothesis-generation loop).
compatibility: Requires Python 3.9+
metadata:
  version: "0.1.0"
---

# Research Question Loop

A **sharpen → score → revise** loop for the *framing* stage of research. The artifact is a small set
of research questions; the feedback signal is how many **clear the bar** — each scored 0-5 on five
fixed axes (Specific, Answerable, Novel, Feasible, Significant). You start from a vague topic, draft
candidates, score each against the rubric (with a light novelty check against the literature), and
rewrite the weakest axis of the promising ones until enough are strong.

A good research question is the hard part of research: too broad and it cannot be answered; too narrow
and it does not matter; already settled and there is no point. The goal is **a few excellent
questions**, not many mediocre ones — this loop drives toward the narrow band that is answerable,
novel, and worth answering.

## Scope & limitations
This loop produces and refines **questions**, grounded by a *light* novelty check (a few searches),
not a full survey — for an exhaustive map use the literature-survey loop, and to turn a question into
testable predictions use the hypothesis-generation loop. The novelty check needs web or literature
access; without it (`novelty_check: none`), novelty is the loop's best judgment and must be labeled
unverified.

## When to use
Use when the user has a topic, area, or rough curiosity and wants it turned into concrete questions
worth pursuing. Default: run the full draft→score→revise loop below. Escape hatch: if the user only
wants candidates rated (no rewriting), score the set once and report the rubric breakdown. Not for
grading a finished proposal, and not for generating hypotheses or experimental designs.

## Setup
Resolve bindings interactively. If `loop.run.yaml` exists in the working dir, load it, confirm the
values in one line, and skip to the loop. Otherwise: on Claude Code (the `AskUserQuestion` tool is
available) infer a likely value for each binding and present it as the recommended option; on other
hosts ask each as a quoted plain-text prompt. Then write `loop.run.yaml` (format:
`examples/run.example.yaml`) and confirm the values before creating any other files.

| binding | meaning | default | how to infer |
|---|---|---|---|
| `<topic>` | the area of interest (field, population, scope, what the user already cares about) | — | ask the user |
| `<n_questions>` | how many strong questions to deliver | 3 | — |
| `<pass_threshold>` | rubric score (0-100) a question must clear to count as strong | 75 | a solid question without demanding perfection |
| `<novelty_check>` | how to check whether a question is already answered: `lit` \| `web` \| `none` | `lit` if the sibling skill is installed, else `web` | probe for the literature-search skill (below) |
| `<report>` | output question set | `<sandbox_root>/questions.md` | — |
| `<sandbox_root>` | where the ledger and report live | `./sandbox` | — |
| `<budget>` | max iterations | 8 | — |

**Novelty toolchain (only for `novelty_check: lit`).** Paper search goes through the sibling
**`literature-search` skill** (`<lit> = <lit_skill_dir>/tools/lit_search.py`, with
`<lit_py> = python3` and `<lit_skill_dir>` its installed location, e.g.
`~/.claude/skills/literature-search/`); the relevant moves are `<lit> search "<q>"` (is a direct
answer already published?) and `<lit> snippet "<q>"` (pinpoint the answering passage). Confirm `<lit>
--help` works at setup; if the skill is absent, tell the user and either install it (copy the repo's
`loops/literature-search` folder into `~/.claude/skills/`) or degrade to `web` (host
WebSearch/WebFetch) or `none`. Record the resolved choice in `<novelty_check>` so re-runs are
non-interactive.

## The loop

The **rubric** (a fresh Grader scores each question 0-5 per axis — see grading below):

| Axis | 5 | 3 | 1 |
|---|---|---|---|
| **Specific** | one clear construct/relationship, well-scoped | direction clear, scope loose | broad/ambiguous topic, not a question |
| **Answerable** | a concrete study/analysis could resolve it; the answer-shape is clear | resolvable in principle, approach unclear | not empirically/analytically decidable |
| **Novel** | open per the novelty check; closest work cited | partly addressed; a real twist remains | already answered (check found a direct answer) |
| **Feasible** | data/methods/access plausibly exist | feasible with effort | needs unavailable data or impossible measurement |
| **Significant** | answering it changes understanding or practice | a useful increment | marginal even if answered |

**Grading — spawn a fresh Grader per iteration (spawn-or-degrade).** Each iteration, spawn a freshly
instantiated **Grader** subagent — separate from whoever drafted or revised the questions, so the
score is independent and not self-graded — and give it each candidate plus its novelty evidence. It
returns the five raw 0-5 per-axis points (no weights). On Claude Code spawn it as a real `Agent`;
otherwise adopt the Grader role inline in a clean pass. The orchestrator sums to a **raw score out of
25**, then converts to the 0-100 score used everywhere:

`total = 100 × raw / 25`   (e.g. raw 20/25 → `total` 80).

A question is **strong** when `total ≥ <pass_threshold>` **and** no axis scored 1 (a single fatal axis
sinks it regardless of `total`).

Copy this checklist and tick items off:
- [ ] Iteration 0 — restate `<topic>` and what is interesting about it; draft 3-5 candidate questions spanning different angles (mechanism, comparison, condition/boundary, application). Record nothing as strong yet.
- [ ] Gather novelty evidence per candidate via `<novelty_check>` (`<lit> search`/`snippet`, or WebSearch, or skip).
- [ ] Score — spawn a **fresh Grader** with each candidate + its evidence; it returns raw 0-5 per axis; convert `raw/25 → total/100`.
- [ ] Diagnose each promising question's **lowest axis** — the one thing keeping it from strong.
- [ ] Revise that one axis (one focused move per question); drop a fatally-flawed question revision cannot save; add a fresh candidate if short.
- [ ] Append a ledger row; stop when `<n_questions>` clear the bar, or at `<budget>`.

**Iteration 0 — frame & draft.** Restate `<topic>` and what is interesting about it; draft 3-5
candidate questions spanning different angles. Record nothing as strong yet.

**Then, until stop (`<n_questions>` strong, or `<budget>`):**

1. **Gather novelty evidence.** Run the `<novelty_check>` for each candidate's core: `<lit>
   search`/`snippet` (or WebSearch). If a direct answer exists, note the closest answered work; if only
   related work exists, note the open part. Each `<lit>` call prints JSON; on failure it prints
   `{"error","fallback"}` and exits non-zero — then fall back to WebSearch/WebFetch.
2. **Score.** Spawn a **fresh Grader** (spawn-or-degrade) and hand it each candidate plus its evidence;
   it returns the raw per-axis points. Convert `raw/25 → total/100`.
3. **Diagnose & revise.** Find each promising question's **lowest axis** and make one focused move on
   it: narrow an over-broad question to a specific population/condition; operationalize an unanswerable
   one into a measurable comparison; pivot an already-answered one toward the part the check showed is
   still open; raise significance by tying it to a decision or a contested claim. Drop questions with a
   fatal axis that revision cannot save; add a fresh candidate if you are short.
4. **Log** one ledger row and continue until `<n_questions>` are strong.

**On stop**, write `<report>`: each strong question with its rubric scores, the novelty note (closest
answered work / the open part), why it is answerable (the study-shape that would resolve it), and why
it matters — plus any runners-up and the axis that held them back.

## Ledger
`<sandbox_root>/ledger.tsv`, tab-separated, never commas in the text. Header:
```
iter	question	total	weakest_axis	revision
```
Example:
```
iter	question	total	weakest_axis	revision
0	how does sleep affect learning	35	specific	drafted; far too broad
1	does sleep timing affect retention	62	answerable	operationalized: spaced-review vs sleep-matched review, 1-week retention
2	does post-learning sleep within 3h beat delayed sleep for procedural retention	86	-	strong (novel per check: tested for declarative not procedural)
```
Report the **best** outcome — the strong questions and their scores — not necessarily the last
iteration's set.

## Constraints
- **A few strong questions beat many weak ones** — do not pad `<report>` with questions that do not
  clear the bar; report them as runners-up with the blocking axis instead.
- **Novelty is checked, not assumed** — when `<novelty_check>` is `lit`/`web`, actually search, cite
  the closest answered work, and never claim novelty the check contradicts. When `none`, label novelty
  unverified.
- **Grade with a fresh Grader** scoring raw 0-5 per axis (no weights); the orchestrator converts
  `raw/25 → 100` and never lets the drafter/reviser grade its own questions, so the score stays honest.
- **One focused revision per question per iteration**, targeting its weakest axis, so improvement is
  attributable and questions converge rather than thrash.
- **Keep the rubric and threshold fixed** so "strong" means the same thing throughout.
- The sandbox is self-contained — no `../` escapes. Do not pause the loop to ask whether to continue;
  run until `<n_questions>` clear the bar or `<budget>` is hit.

© gaasher · MIT · gaasher/Agent-Loop-Skills

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

Все скиллы по теме «Наука и исследования» →
paper-reading-research-question franklee16 Скилл paper-reading-research-question разворачивает готовую карту поля в проверяемые исследовательские вопросы: углы, проверка доказательств, карточки вопросов. CX Codex +1 ★ 240звёзд репо nature-citation Yuan1z skill, refactored into static/dynamic layers Скилл nature-citation для Claude Code ищет и проверяет статьи Nature и семейства CNS в поддержку утверждений рукописи. Он связывает тезисы с источниками и готовит файл для менеджера библиографии. CX Codex +1 17 200установок literature-search-arxiv google-deepmind Скилл literature-search-arxiv ищет статьи и препринты на arXiv, вытаскивает метаданные и абстракты, скачивает PDF, HTML или LaTeX-исходники в рабочую папку. CX Codex +1 3 700установок pubmed-database google-deepmind Скилл pubmed-database даёт агенту доступ к PubMed и PubMed Central: искать статьи, вытаскивать абстракты и полный текст, связывать публикации с биологическими базами. CX Codex +1 3 000установок ccf-literature-searcher mikubaka88 Скилл ccf-literature-searcher для Claude Code ищет и проверяет научные работы, датасеты и бенчмарки. Запускается для подбора источников к обзору литературы или карты исследовательских возможностей. CX Codex +1 2 300установок novelty-assessment lingzhi227 Скилл novelty-assessment прогоняет исследовательскую идею через поиск по научным статьям и выносит вердикт: новая или нет. Пригодится до того, как вы вложитесь в направление. CX Codex +1 1 900установок

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

Весь набор →
claim-verify Скилл claim-verify проверяет числовые утверждения из черновика отчёта по исходным данным. Находит расхождения, тестирует выводы на выбросы и уточняет формулировки перед публикацией. CX Codex +1 ★ 185звёзд репо literature-survey Скилл literature-survey для Claude Code строит обзор исследований в виде матрицы источников и утверждений. Он подключается для поиска согласий, противоречий и пробелов по вопросу. CX Codex +1 ★ 185звёзд репо optimize-loop Скилл optimize-loop гоняет цикл правок с жёстким гейтом корректности и метрикой, которую надо снизить: рефакторинг модуля под зелёные тесты или ускорение SQL-запроса с тем же набором строк. CX Codex +1 ★ 185звёзд репо research-proposal Скилл research-proposal для Claude Code итеративно проверяет черновик научной заявки по публикациям и дорабатывает его по оценке судей до проходного балла. CX Codex +1 ★ 185звёзд репо karpathy Скилл karpathy для Claude Code, который превращает агента в автономного ML-исследователя: тот правит тренировочный код, запускает обучение и оставляет изменения, снижающие одну метрику. CX Codex +1 ★ 185звёзд репо dueling-autoresearch Скилл dueling-autoresearch запускает параллельное соревнование двух разных подходов по общей метрике качества. Помогает сравнить эвристику и машинное обучение в честном цикле. CX Codex +1 ★ 185звёзд репо plan-loop Скилл plan-loop превращает запрос на разработку в план с задачами, файлами и тестами. Он нужен до написания кода, когда работу предстоит передать исполнителю или другой модели. CX Codex +1 ★ 185звёзд репо purple-team Скилл purple-team гоняет атаку и защиту одним циклом: red-team находит классы отказов у вашего фильтра или промпта, blue-team латает, свежий прогон проверяет. Пока не станет сухо. CX Codex +1 ★ 185звёзд репо

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

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