Agent skill

Brainstorming

by xenitV1 in xenitV1/Antigravity-Workflows

Socratic questioning protocol + user communication. An agent skill from xenitV1/Antigravity-Workflows.

MITAuto-check passedAgent Workflows

Install Brainstorming

skills CLI
$ npx skills add xenitV1/Antigravity-Workflows --skill brainstorming -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install xenitV1/Antigravity-Workflows brainstorming --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/xenitV1/Antigravity-Workflows.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/brainstorming .claude/skills/brainstorming && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
brainstorming
GitHub stars
130
Token cost
~1.1k tokens
SKILL.md length
329 words
Files
2
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

Socratic questioning protocol + user communication. An agent skill from xenitV1/Antigravity-Workflows.

  • Works in 3 steps: STOP - Do NOT start coding → ASK - Minimum 3 questions → WAIT - Get response before proceeding
  • Tasks that involve Brainstorming
  • SKILL.md covers 🛑 SOCRATIC GATE (ENFORCEMENT), 🧠 Dynamic Question Generation, Progress Reporting… and Error Handling (PRINCIPLE-BASED), plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Brainstorming is an agent skill from xenitV1/Antigravity-Workflows. Socratic questioning protocol + user communication. MANDATORY for complex requests, new features, or unclear requirements. Includes progress reporting and error handling.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `dynamic-questioning.md`).

It sits in Agent Workflows, covering Brainstorming and Tutoring and explanations. The licence is MIT.

When your agent uses it

  • Tasks that involve Brainstorming
  • Tasks that involve Tutoring and explanations

Example prompts

  • “/brainstorming”

Requirements

  • Pre-approved tools (allowed-tools): Read, Glob, Grep

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. STOP - Do NOT start coding
  2. ASK - Minimum 3 questions
  3. WAIT - Get response before proceeding

What it can do on your machine

Read from SKILL.md and the folder at commit f0a1fa7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brainstorming loads about 1.1k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 329 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from xenitV1/Antigravity-Workflows at commit f0a1fa7, republished under its MIT licence (© xenitV1). 329 words, ~1,149 tokens.

Download SKILL.mdSave it as .claude/skills/brainstorming/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
brainstorming
description
Socratic questioning protocol + user communication. MANDATORY for complex requests, new features, or unclear requirements. Includes progress reporting and error handling.
allowed-tools
Read, Glob, Grep

Brainstorming & Communication Protocol

MANDATORY: Use for complex/vague requests, new features, updates.


🛑 SOCRATIC GATE (ENFORCEMENT)

When to Trigger
PatternAction
"Build/Create/Make [thing]" without details🛑 ASK 3 questions
Complex feature or architecture🛑 Clarify before implementing
Update/change request🛑 Confirm scope
Vague requirements🛑 Ask purpose, users, constraints
🚫 MANDATORY: 3 Questions Before Implementation
  1. STOP - Do NOT start coding
  2. ASK - Minimum 3 questions:
    • 🎯 Purpose: What problem are you solving?
    • 👥 Users: Who will use this?
    • 📦 Scope: Must-have vs nice-to-have?
  3. WAIT - Get response before proceeding

🧠 Dynamic Question Generation

⛔ NEVER use static templates. Read dynamic-questioning.md for principles.

Core Principles
PrincipleMeaning
Questions Reveal ConsequencesEach question connects to an architectural decision
Context Before ContentUnderstand greenfield/feature/refactor/debug context first
Minimum Viable QuestionsEach question must eliminate implementation paths
Generate Data, Not AssumptionsDon't guess—ask with trade-offs
Question Generation Process
1. Parse request → Extract domain, features, scale indicators
2. Identify decision points → Blocking vs. deferable
3. Generate questions → Priority: P0 (blocking) > P1 (high-leverage) > P2 (nice-to-have)
4. Format with trade-offs → What, Why, Options, Default
Question Format (MANDATORY)
markdown
### [PRIORITY] **[DECISION POINT]**

**Question:** [Clear question]

**Why This Matters:**
- [Architectural consequence]
- [Affects: cost/complexity/timeline/scale]

**Options:**
| Option | Pros | Cons | Best For |
|--------|------|------|----------|
| A | [+] | [-] | [Use case] |

**If Not Specified:** [Default + rationale]

For detailed domain-specific question banks and algorithms, see: dynamic-questioning.md


Progress Reporting (PRINCIPLE-BASED)

PRINCIPLE: Transparency builds trust. Status must be visible and actionable.

Status Board Format
AgentStatusCurrent TaskProgress
[Agent Name]✅🔄⏳❌⚠️[Task description][% or count]
Status Icons
IconMeaningUsage
✅CompletedTask finished successfully
🔄RunningCurrently executing
⏳WaitingBlocked, waiting for dependency
❌ErrorFailed, needs attention
⚠️WarningPotential issue, not blocking

Error Handling (PRINCIPLE-BASED)

PRINCIPLE: Errors are opportunities for clear communication.

Error Response Pattern
1. Acknowledge the error
2. Explain what happened (user-friendly)
3. Offer specific solutions with trade-offs
4. Ask user to choose or provide alternative
Error Categories
CategoryResponse Strategy
Port ConflictOffer alternative port or close existing
Dependency MissingAuto-install or ask permission
Build FailureShow specific error + suggested fix
Unclear ErrorAsk for specifics: screenshot, console output

Completion Message (PRINCIPLE-BASED)

PRINCIPLE: Celebrate success, guide next steps.

Completion Structure
1. Success confirmation (celebrate briefly)
2. Summary of what was done (concrete)
3. How to verify/test (actionable)
4. Next steps suggestion (proactive)

Communication Principles

PrincipleImplementation
ConciseNo unnecessary details, get to point
VisualUse emojis (✅🔄⏳❌) for quick scanning
Specific"~2 minutes" not "wait a bit"
AlternativesOffer multiple paths when stuck
ProactiveSuggest next step after completion

Anti-Patterns (AVOID)

Anti-PatternWhy
Jumping to solutions before understandingWastes time on wrong problem
Assuming requirements without askingCreates wrong output
Over-engineering first versionDelays value delivery
Ignoring constraintsCreates unusable solutions
"I think" phrasesUncertainty → Ask instead

© xenitV1, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/brainstorming of xenitV1/Antigravity-Workflows.

  • SKILL.md
  • dynamic-questioning.md

Open the folder on GitHubat commit f0a1fa7

Compare with similar skills

Brainstorming next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brainstorming compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brainstorming this skillxenitV1/Antigravity-Workflows130—~1.1kAutomated safety check: PassMIT
Gsd Exploreopen-gsd/gsd-core10k2 repos~176Automated safety check: NotesMIT
Yao Bayesian Skillyaojingang/yao-open-skills1.3k—~956Automated safety check: PassMIT
Yao Gametheory Skillyaojingang/yao-open-skills1.3k—~1kAutomated safety check: PassMIT
Socratic BrainstormTheBeardedBearSAS/claude-craft107—~1.2kAutomated safety check: PassMIT
Brainstorminged3dai/ed3d-plugins2501 repos~4.3kAutomated safety check: PassNone

Similar skills

  • Gsd Explore

    open-gsd/gsd-core

    Socratic ideation and idea routing — think through ideas before committing to plans

    10k GitHub starsUsed in 2 repos~176 tokens
    Agent WorkflowsAuto-check: notes
  • Yao Bayesian Skill

    yaojingang/yao-open-skills

    Convert uncertain real-world choices into an auditable Bayesian evidence-to-action report with priors, evidence grading, posterior update, action thresholds, sensitivity checks, multi-turn decision…

    1.3k GitHub stars~956 tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Yao Gametheory Skill

    yaojingang/yao-open-skills

    Route CEO-facing competition, negotiation, channel, pricing, platform, M&A, financing, competitor-response, alliance, and regulator problems through an applied game-theory framework router when…

    1.3k GitHub stars~1k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Socratic Brainstorm

    TheBeardedBearSAS/claude-craft

    Brainstorming socratique AVANT de coder - clarifier le problème par questions ciblées plutôt que sauter à la solution.

    107 GitHub stars~1.2k tokensUpdated 24 days ago
    Agent WorkflowsAuto-check passed
  • Brainstorming

    ed3dai/ed3d-plugins

    A skill your agent uses when creating or developing anything, before writing code or implementation plans - refines rough ideas into fully-formed designs through structured Socratic questioning…

    250 GitHub starsUsed in 1 repo~4.3k tokens
    Agent WorkflowsAuto-check passed
  • Brainstorm

    andrew-yangy/gru-ai

    Structured brainstorm — from quick Socratic refinement to full C-suite strategy sessions.

    155 GitHub stars~3.2k tokensUpdated 7 mo ago
    Agent WorkflowsAuto-check passed

More from xenitV1/Antigravity-Workflows

All 42 skills in this repo
  • Parallel Agents

    xenitV1/Antigravity-Workflows

    Native multi-agent orchestration using Claude Code's Agent Tool.

    130 GitHub starsUsed in 9 repos~1.3k tokens
    Auto-check passed
  • Mobile Design

    xenitV1/Antigravity-Workflows

    Mobile-first design thinking and decision-making for iOS and Android apps.

    130 GitHub starsUsed in 2 repos~3.7k tokens
    Auto-check: notes
  • Bash Linux

    xenitV1/Antigravity-Workflows

    Bash/Linux terminal patterns. An agent skill from xenitV1/Antigravity-Workflows.

    130 GitHub starsUsed in 8 repos~1k tokens
    Auto-check: notes
  • Performance Profiling

    xenitV1/Antigravity-Workflows

    Performance profiling principles. An agent skill from xenitV1/Antigravity-Workflows.

    130 GitHub starsUsed in 8 repos~772 tokens
    Auto-check: notes
  • Plan Writing

    xenitV1/Antigravity-Workflows

    Structured task planning with clear breakdowns, dependencies, and verification criteria.

    130 GitHub starsUsed in 8 repos~994 tokens
    Auto-check passed
  • Behavioral Modes

    xenitV1/Antigravity-Workflows

    AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate).

    130 GitHub starsUsed in 7 repos~1.3k tokens
    Auto-check passed

Questions about Brainstorming

What does Brainstorming do?

Socratic questioning protocol + user communication. An agent skill from xenitV1/Antigravity-Workflows. Brainstorming is an agent skill from xenitV1/Antigravity-Workflows. Socratic questioning protocol + user communication.

When should I use Brainstorming?

Brainstorming fits situations like: tasks that involve Brainstorming; tasks that involve Tutoring and explanations.

How do I install Brainstorming in Claude Code?

Run `npx skills add xenitV1/Antigravity-Workflows --skill brainstorming -a claude-code`. Or copy the skill folder (skills/brainstorming in xenitV1/Antigravity-Workflows) into .claude/skills/brainstorming in your project. Claude Code loads it when a task matches its description.

How do I install Brainstorming in Codex?

Run `npx skills add xenitV1/Antigravity-Workflows --skill brainstorming -a codex`. Or copy the skill folder (skills/brainstorming in xenitV1/Antigravity-Workflows) into .agents/skills/brainstorming in your project. Codex loads it when a task matches its description.

Can I use Brainstorming in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add xenitV1/Antigravity-Workflows --skill brainstorming -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brainstorming, .gemini/skills/brainstorming, .github/skills/brainstorming and .opencode/skills/brainstorming in your project.

What does Brainstorming need to run?

SKILL.md names no scripts, command-line tools or credentials: Brainstorming is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Glob, Grep.

Does Brainstorming access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Brainstorming safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Brainstorming use?

Brainstorming is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brainstorming use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Brainstorming?

Skills that share tags, products or a category with Brainstorming: Gsd Explore (open-gsd/gsd-core, 10k stars), Yao Bayesian Skill (yaojingang/yao-open-skills, 1.3k stars), Yao Gametheory Skill (yaojingang/yao-open-skills, 1.3k stars) and Socratic Brainstorm (TheBeardedBearSAS/claude-craft, 107 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brainstorming?

xenitV1 (a GitHub user) maintains it in xenitV1/Antigravity-Workflows, which has 130 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on January 14, 2026.

Source: xenitV1/Antigravity-Workflows on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.