jrag: Skill for Claude Code

.agents/skills/brainstorming/SKILL.md

brainstorming is a skill for Claude Code, Codex from HumanBean17/jrag. It costs 38 tokens per session (2,892 once invoked), scanned A, original, MIT.

A conversation-led design process for turning an idea into a clear software specification before implementation begins.

In plain words
What is it for?
Use it to clarify goals, study relevant context, ask focused questions, and agree on what should be built.
Why use it?
It prevents coding from starting with unclear requirements or hidden assumptions.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is HumanBean17/jrag's own configuration. It tells Claude Code and Codex how to work on jrag itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything jrag configures →

Reuse

Borrowing it

Nothing to install: this file belongs to HumanBean17/jrag. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/HumanBean17/jrag/master/.agents/skills/brainstorming/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/HumanBean17/jrag

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 brainstorming

README.md
[![agentmods](https://agentmods.dev/badge/skills/humanbean17/jrag/brainstorming/github.svg)](https://agentmods.dev/skills/humanbean17/jrag/brainstorming)
Your own site
<a href="https://agentmods.dev/skills/humanbean17/jrag/brainstorming"><img src="https://agentmods.dev/badge/skills/humanbean17/jrag/brainstorming/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for brainstorming

Your own site · 80×15
<a href="https://agentmods.dev/skills/humanbean17/jrag/brainstorming"><img src="https://agentmods.dev/badge/skills/humanbean17/jrag/brainstorming.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 38 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,892 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. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Rogue Agent · line 29
    Skill establishes unauthorized persistence across sessions via cron jobs, startup scripts, or state files. Session persistence allows an attacker to maintain access beyond the current interaction.
    Fix: Remove any persistence mechanisms (cron jobs, startup scripts, state files). Skills should not maintain state across sessions without explicit user consent.
How audits are shown
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.00038 $0.02892
Opus 5.5 $0.00015 $0.01157
Sonnet 5.5 $0.00008 $0.00578
Haiku 4.5 $0.00004 $0.00289

Measured 2mo ago against content hash 0d3bd709129d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

brainstorming 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 2mo 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.

.agents/skills/brainstorming/SKILL.md · 190 lines

How it starts

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

Brainstorming Ideas Into Designs

Help turn ideas into fully formed designs and specs through natural collaborative dialogue.

Start by reading the context the user gave you, then study the codebase, then ask questions one at a time to refine the idea. Once you understand what you're building, present the design and get user approval.

Core Principles

These principles override the rest of this skill when in conflict.

  1. Context before code. Before exploring the codebase, carefully read the context the user provided - the task description, linked tickets, attached files, references, and any constraints stated in the message. Only then explore the code. The design must reflect what the user actually asked for, not what you assume.
  2. Specs carry design, not code. The spec describes WHAT to build and WHY, with references to classes, methods, fields, configurations, tables, DTOs, and contracts (JSON Schema, schemas, config). It MUST NOT contain implementation logic - method bodies, algorithms, or actual code. Writing code is the job of the agent that implements the plan. Your job here is to design.

Anti-Pattern: "This Is Too Simple To Need A Design"

Every project goes through this process — a todo list, a single-function utility, a config change, all of them. "Simple" projects are where unexamined assumptions cause the most wasted work. The design can be short (a few sentences for truly simple projects), but you MUST present it and get approval. What's optional is the written spec (see below) — the design conversation itself never is.

Checklist

You MUST create a task for each of these items and complete them in order:

  1. Read the provided context - the task description, linked tickets, attachments, and any constraints the user stated. Parse intent and boundaries before touching the codebase
  2. Explore project context — check files, docs, recent commits
  3. Ask clarifying questions — one at a time, understand purpose/constraints/success criteria
  4. Propose 2-3 approaches — with trade-offs and your recommendation
  5. Present design — in sections scaled to their complexity, get user approval after each section
  6. Ask whether to write a spec — once the design is approved, mark all previous tasks (1-5) as completed, then ask the user. The design conversation is mandatory; the spec document is not. For trivial changes the approved design alone may be enough; for anything non-trivial, default to writing one.
    • No spec → mark all brainstorming tasks complete, then proceed to implementation (no spec doc, no plan).
    • Yes spec → continue to steps 7-11.
  7. Template fit check — if a project-level docs/superpowers/spec-template.md exists, map the approved design onto it; surface every mismatch in one message and ask before deviating. Skip if absent. See Custom Spec Template.
  8. Write design doc — save to docs/superpowers/specs/active/YYYY-MM-DD-<topic>-design.md and commit
  9. Spec self-review — quick inline check for placeholders, contradictions, ambiguity, scope (see below)
  10. User reviews written spec — ask user to review the spec file before proceeding
  11. Transition to implementation — invoke writing-plans skill to create implementation plan

Read the full file on GitHub · 190 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. 2mo ago First seen · 190 lines · 38 tokens per session scan A 0d3bd709129d

Subscribe to this mod's changes

brainstorming is a skill published in the GitHub repository HumanBean17/jrag (9 stars, last pushed 1mo ago), licensed MIT. It adds 38 tokens to every session and 2,892 once invoked, about $0.0002 per session on Opus 5.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

sync

Run /sync as the last step after a change is complete, around merge, to keep durable knowledge current. Updates root and nested AGENTS.md, reconciles the scope from repo evidence, and flags specs the change made stale. Surgical edits only: it adds lines, and rewrites single lines it owns. Never a whole section, never…

jsmastery-pro/skills · 73 tokens

debug

Run /debug to find and fix a bug's root cause: a test failing for an unclear reason, /check verify finding a failure, or behavior being wrong. Runs a reproduce, localize, hypothesize, test, fix, verify loop, makes the minimal fix, and hands a regression test to /test. No features, no extra refactors.

jsmastery-pro/skills · 74 tokens

architect

Run /architect when choosing between approaches, designing a feature or page, picking a tech stack, or when /develop says a decision is owed, anytime a load bearing technical decision is unmade. Asks deep questions, recommends an answer, and writes a build spec to docs/specs/. Owns all spec files.

jsmastery-pro/skills · 66 tokens

scope

Run /scope to turn a product idea into a living, coarse scope in docs/scope/ and keep it current: plan a new product, plan the next slice, enroll one named feature, or run with no argument to reconcile after shipping and queue what is next. Seeds WHAT to build; /architect designs, /develop builds.

jsmastery-pro/skills · 69 tokens

java

Java language and JVM engineering standards — records and sealed-type modelling, JSpecify null-safety with NullAway as a build error, immutability, virtual threads and modern concurrency, Error Prone/ArchUnit/PIT build gates, JUnit 6 testing doctrine, and boundary security. Load whenever writing, refactoring, or…

olehsvyrydov/AI-development-team · 136 tokens

vigilante-issue-implementation-on-java-kotlin

Implement a GitHub issue end-to-end when Vigilante dispatches work for a Java or Kotlin repository with JVM build-tool, style, and secure-coding guidance.

aliengiraffe/vigilante · 45 tokens