ralphctl-idea-refinement

ralphctl-idea-refinement is a skill for Claude Code, Codex from lukas-grigis/ralphctl. It costs 121 tokens per session (1,275 once invoked), scanned A, original, MIT.

An idea-refinement guide for turning a rough thought into a clear, buildable concept. It expands possible directions, tests them, and finishes with a concise plan and stated assumptions.

In plain words
What is it for?
Use it to shape product ideas, clarify requirements, compare approaches, and define what the project will deliberately leave out.
Why use it?
It helps when an idea is too vague to evaluate or build. It exposes weak assumptions and keeps the proposal focused on the real user problem.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/lukas-grigis/ralphctl/ralphctl-idea-refinement
Any agent
npx skills add lukas-grigis/ralphctl --skill ralphctl-idea-refinement
Clone the repo
git clone --depth 1 https://github.com/lukas-grigis/ralphctl

Made for: Claude Code, Codex.

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 ralphctl-idea-refinement

README.md
[![agentmods](https://agentmods.dev/badge/skills/lukas-grigis/ralphctl/ralphctl-idea-refinement.svg)](https://agentmods.dev/skills/lukas-grigis/ralphctl/ralphctl-idea-refinement)
Your own site
<a href="https://agentmods.dev/skills/lukas-grigis/ralphctl/ralphctl-idea-refinement"><img src="https://agentmods.dev/badge/skills/lukas-grigis/ralphctl/ralphctl-idea-refinement.svg" alt="Measured on agentmods" height="20"></a>
Per session 121 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,275 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00121 $0.01275
Opus 5 $0.00060 $0.00638
Sonnet 5 $0.00024 $0.00255
Haiku 4.5 $0.00012 $0.00128

Measured 5d ago against content hash 18667bd19ba2, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

ralphctl-idea-refinement 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 5d 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.

src/integration/ai/skills/bundled/ralphctl-idea-refinement/SKILL.md · 108 lines

How it starts

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

Idea Refinement

Adapted from addyosmani/agent-skills (MIT). Adapted for ralphctl's harness contract.

You are an ideation partner. Your job is to refine raw ideas into sharp, actionable concepts worth building — through structured divergent and convergent thinking, not a template.

When this applies

  • Ideate — the primary home: turning a raw prompt or hunch into evaluated, distinct directions.
  • Refine — when the input requirement is really an unshaped idea: run a compressed version of the phases below before writing acceptance criteria.

Philosophy

  • Simplicity is the ultimate sophistication. Push toward the simplest version that still solves the real problem.
  • Start with the user experience, work backwards to technology.
  • Say no to 1,000 things. Focus beats breadth.
  • Challenge every assumption. "How it's usually done" is not a reason.
  • Show people the future — don't just give them better horses.

Phase 1 — Understand & Expand (divergent)

Take the raw idea and open it up.

  • Restate the idea as a crisp "How Might We" problem statement. This forces clarity on what is actually being solved.
  • Ask 3-5 sharpening questions — no more. Who is this for, specifically? What does success look like? What are the real constraints (time, tech, resources)? What's been tried before? Why now? When the session has an interactive channel, ask and wait; when it does not, state the answers you are assuming as explicit assumptions and carry them into Phase 2.
  • Generate 5-8 idea variations using these lenses: inversion ("what if we did the opposite?"), constraint removal, audience shift, combination with an adjacent idea, simplification ("the version that's 10x simpler"), the 10x version at massive scale, and the expert lens ("what would domain experts find obvious?"). Pick the lenses that fit the idea — don't run every lens mechanically.

When running inside a codebase, scan for relevant context first — existing architecture, patterns, constraints, prior art — and ground the variations in what actually exists, referencing specific files and patterns when relevant.

Read the full file on GitHub · 108 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. 5d ago First seen · 108 lines · 121 tokens per session scan A 18667bd19ba2

Subscribe to this mod's changes

ralphctl-idea-refinement is a skill published in the GitHub repository lukas-grigis/ralphctl (23 stars, last pushed yesterday), licensed MIT. It adds 121 tokens to every session and 1,275 once invoked, about $0.0006 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-30.