formalize-problem

formalize-problem is a skill for Claude Code from SebastianElvis/reaper. It costs 48 tokens per session (1,407 once invoked), scanned A, original, Apache-2.0.

A research-planning tool that turns a broad research goal into precise hypotheses, assumptions, and conditions for success or failure.

In plain words
What is it for?
Use it to define or narrow a research problem after analysing papers, including questions about whether a claim or proof holds under specific conditions.
Why use it?
It removes ambiguity about what a research project is testing and how its result will be judged.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter.

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is [One field per dimension from `../reaper/references/model.md`. Every dimension must have a concrete answer.].

Part of the reaper plugin — 10 skills shipped together

Good fit Use it to define or narrow a research problem after analysing papers, including questions about whether a claim or proof holds under specific conditions.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/SebastianElvis/reaper
agentmods
npx agentmods add skills/sebastianelvis/reaper/formalize-problem

Made for: Claude Code.

Or install reaper, the plugin that ships this one along with the rest of its 10 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for formalize-problem

README.md
[![agentmods](https://agentmods.dev/badge/skills/sebastianelvis/reaper/formalize-problem.svg)](https://agentmods.dev/skills/sebastianelvis/reaper/formalize-problem)
Your own site
<a href="https://agentmods.dev/skills/sebastianelvis/reaper/formalize-problem"><img src="https://agentmods.dev/badge/skills/sebastianelvis/reaper/formalize-problem.svg" alt="Measured on agentmods" height="20"></a>
Per session 48 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,407 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00048 $0.01407
Opus 5 $0.00024 $0.00704
Sonnet 5 $0.00010 $0.00281
Haiku 4.5 $0.00005 $0.00141

Measured 8d ago against content hash 4b0ec6d45f31, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

formalize-problem scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/formalize-problem/SKILL.md · 121 lines

How it starts

The opening of the file, as written. The whole thing — 121 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Formalize Problem

Transform a research goal into precise, testable hypotheses with explicit success/failure conditions.

Usage

Invoke this skill by name with the research goal as a quoted string. On slash-command hosts, prefix with / (e.g. /formalize-problem "<goal>").

formalize-problem "determine if the security proof in Section 4 holds under asynchrony"

Instructions

1. Read Inputs

Always read:

  • reaper-workspace/notes/clarified-goal.md — refined research goal, scope, assumptions, and success criteria
  • reaper-workspace/notes/paper-summary.md — what the paper claims and how. If this file does not exist (paper-less mode), proceed without it — use the literature review and clarified goal as primary inputs instead.
  • The research goal from the argument (use the refined goal from clarified-goal.md if available)

Read selectively from:

  • reaper-workspace/notes/literature.md — focus on the "Key Prior Results" and "Gaps Identified" sections, not the full paper tables. Only deep-read individual paper entries if a specific prior result is needed for hypothesis screening. In paper-less mode, this becomes the primary technical context — read it more thoroughly.

2. Identify the Core Question

What exactly needs to be resolved? Be specific. "Is this protocol secure?" is too vague. "Does the safety proof of Protocol X hold when the adversary is adaptive rather than static?" is testable.

3. Pin Down Model Assumptions (must be unambiguous before hypotheses)

Pin down every dimension of the system/trust model. If any dimension is left vague, the investigation will produce ambiguous results. Consult ../reaper/references/model.md for the domain-appropriate checklist of dimensions that must be specified. Every field must have a concrete answer, not "TBD".

Every hypothesis must reference these model assumptions by specifying which parameters it holds under. A hypothesis that states a claim without pinning every relevant dimension is rejected.

Read the full file on GitHub · 121 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 121 lines · 48 tokens per session scan A 4b0ec6d45f31

Subscribe to this mod's changes

formalize-problem is a skill published in the GitHub repository SebastianElvis/reaper (9 stars, last pushed 4mo ago), licensed Apache-2.0. It adds 48 tokens to every session and 1,407 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

content-refinement-agent

Step 5 of the PaperOrchestra pipeline (arXiv:2604.05018). Iteratively refine drafts/paper.tex by simulating peer review and applying targeted revisions, with strict accept/revert halt rules, deterministic 0-100 decision bands (Accept/Minor/Major/Reject) that drive a target-met early stop, and a Devil's Advocate…

Ar9av/PaperOrchestra · 145 tokens

literature-review-agent

Step 3 of the PaperOrchestra pipeline (arXiv:2604.05018). Execute the literature search strategy from outline.json — discover candidate papers via web search, verify them through Semantic Scholar (Levenshtein > 70 fuzzy title match, temporal cutoff, dedup by paperId), cross-corroborate against Crossref + OpenAlex to…

Ar9av/PaperOrchestra · 149 tokens

agent-research-aggregator

Pre-pipeline aggregator that scans AI agent cache directories (.claude, .cursor, .antigravity, .openclaw) or any user-specified directory for experimentation logs, extracts insights and numeric results, and formats them as PaperOrchestra-ready inputs (idea.md + experimentallog.md). TRIGGER when the user says…

Ar9av/PaperOrchestra · 177 tokens

paper-orchestra

Orchestrate the full PaperOrchestra (Song et al., 2026, arXiv:2604.05018) five-agent pipeline to turn unstructured research materials (idea, experimental log, LaTeX template, conference guidelines, optional figures) into a submission-ready LaTeX manuscript and compiled PDF. TRIGGER when the user asks to "write a paper…

Ar9av/PaperOrchestra · 143 tokens

section-writing-agent

Step 4 of the PaperOrchestra pipeline (arXiv:2604.05018). ONE single multimodal LLM call that drafts the remaining paper sections (Abstract, Methodology, Experiments, Conclusion), extracts numeric values from experimentallog.md into LaTeX booktabs tables, splices the generated figures from Step 2, and merges…

Ar9av/PaperOrchestra · 125 tokens

paper-autoraters

Run the four paper-quality autoraters from PaperOrchestra (arXiv:2604.05018, App. F.3) — Citation F1 (P0/P1 partition + Precision/Recall/F1), Literature Review Quality (6-axis 0-100 with anti-inflation rules), SxS Overall Paper Quality (side-by-side), and SxS Literature Review Quality (side-by-side). TRIGGER when the…

Ar9av/PaperOrchestra · 121 tokens