Agent skill

Brainstorm

by mhmzdev in mhmzdev/the-holy-quran-app

Explore WHAT to build for The Holy Qur'an app through collaborative dialogue before any planning or code.

MITAuto-check passedAgent Workflows

Install Brainstorm

skills CLI
$ npx skills add mhmzdev/the-holy-quran-app --skill brainstorm -a claude-code

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

GitHub CLI
$ gh skill install mhmzdev/the-holy-quran-app brainstorm --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/mhmzdev/the-holy-quran-app.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/brainstorm .claude/skills/brainstorm && 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
brainstorm
GitHub stars
889
Token cost
~845 tokens
SKILL.md length
391 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Explore WHAT to build for The Holy Qur'an app through collaborative dialogue before any planning or code.

  • Works in 4 steps: Scope the idea → Understand → Write the brainstorm doc → …
  • The user says brainstorm
  • SKILL.md covers Guiding principles, Flow and What NOT to do
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Brainstorm is an agent skill from mhmzdev/the-holy-quran-app. Explore WHAT to build for The Holy Qur'an app through collaborative dialogue before any planning or code. Use when the user says "brainstorm", "let's explore", "think through this", "what should we build", or when a request is fuzzy enough that jumping to a plan would guess at scope. Produces a brainstorm doc in docs/brainstorm/.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Brainstorming. It works with Flutter and Android. The repository describes itself as: Holy Qur'an application developed via Flutter. The licence is MIT.

When your agent uses it

  • The user says brainstorm
  • Think through this
  • What should we build
  • A request is fuzzy enough that jumping to a plan would guess at scope

Example prompts

  • “brainstorm”
  • “s explore”
  • “think through this”
  • “/brainstorm”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Scope the idea
  2. Understand
  3. Write the brainstorm doc
  4. Handoff (AskUserQuestion)

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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

Brainstorm loads about 845 tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 391 words of instructions outside code blocks.

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

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 mhmzdev/the-holy-quran-app at commit 33edb90, republished under its MIT licence (© mhmzdev). 391 words, ~845 tokens.

Download SKILL.mdSave it as .claude/skills/brainstorm/SKILL.md (or your agent's skills folder).
name
brainstorm
description
Explore WHAT to build for The Holy Qur'an app through collaborative dialogue before any planning or code. Use when the user says "brainstorm", "let's explore", "think through this", "what should we build", or when a request is fuzzy enough that jumping to a plan would guess at scope. Produces a brainstorm doc in docs/brainstorm/.
argument-hint
the feature or idea to explore

Brainstorm

You are exploring an idea before it becomes a plan. Nail down WHAT to build and WHY — not HOW. No code, no file lists, no phases; those belong to /plan.

Cycle: /brainstorm → /grill-me → /plan → /build → /review — every arrow is a human-approval gate. Hand off, never auto-chain. For small, low-risk ideas skip straight to /plan.

Guiding principles

  1. Ruthless YAGNI. Solo-maintained app with ~1k users and no backend. Solve the problem in front of you, never a hypothetical one. When in doubt, cut.
  2. Prefer existing patterns. Bloc + get_it + Provider, the two-package data layer, Hive cache-first, the configs token layer. Check AGENTS.md, docs/architecture/overview.md and docs/features/ before inventing.
  3. One question at a time. Ask the single most decision-unblocking question, prefer multiple-choice with a recommended default, wait, then continue.
  4. Look before you ask. If the answer is in the code or docs/, read it.

Flow

Step 0 — Scope the idea

Classify what it touches: a screen/widget (lib/ui/), a bloc (lib/blocs/), the data layer (packages/al_quran_api / al_quran_repo, Hive schema — typeId implications!), platform/release (android/, Play policy), or the web build (currently broken, see docs/platforms/web.md). If the request is already crisp and small, say so and recommend /plan or just doing it.

Show full SKILL.md (193 more words)Show less
Step 1 — Understand
  1. Lightweight codebase pass: read the 1–3 files that matter (the closest screen, the bloc, the data-provider method). Not an audit.
  2. Collaborative questioning, one at a time: Who hits this and when (reader, first-time user, offline user)? Smallest version that delivers the value? Does it need new cached data (Hive model → typeId, migration for existing users)? Which existing screen/bloc is closest?
  3. Explore 2–3 concrete approaches: one line each, what it reuses, its trade-off, how it fits the layering. Recommend one.
Step 2 — Write the brainstorm doc

docs/brainstorm/<kebab-topic>.md with OKF frontmatter (type: Brainstorm, title, description, tags, timestamp) and:

markdown
## Problem
## Goal
## Approaches considered
1. **<Name>** — <one line>. Reuses <X>. Trade-off: <Y>.
**Leaning toward:** <which, why>
## Surfaces touched
## Open questions
- [ ] ...
## Out of scope (YAGNI)

Keep it tight — a thinking artifact, not a spec. Add a line to docs/log.md.

Step 3 — Handoff (AskUserQuestion)
  • Grill it → /grill-me (recommended for anything touching Hive schema, navigation, or release).
  • Plan it → /plan for small, low-risk ideas.
  • Refine → /refine-approach on the doc.
  • Pause → leave the doc and stop.

What NOT to do

  • No implementation phases, file lists, or code.
  • Don't invent requirements the user never raised — capture what was discussed, mark the rest as open questions.
  • Don't skip the codebase pass; this app almost always has a pattern to lean on.

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

Files

Just SKILL.md in .agents/skills/brainstorm of mhmzdev/the-holy-quran-app.

Open the folder on GitHubat commit 33edb90

Compare with similar skills

Brainstorm 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.

Brainstorm compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brainstorm this skillmhmzdev/the-holy-quran-app889—~845Automated safety check: PassMIT
Skill CreatorChevey339/kelivo4.2k—~1.3kAutomated safety check: PassAGPL-3.0
Retrieving Developer Knowledgegoogle/skills21k—~2kAutomated safety check: PassApache-2.0
Frb Android Emulator Preparefzyzcjy/flutter_rust_bridge5.4k—~2.1kAutomated safety check: NotesMIT
Stack Previewvicoa-ai/vicoa490—~1.8kAutomated safety check: NotesAGPL-3.0
Claude Android NinjaDrjacky/claude-android-ninja124—~5.2kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Chevey339/kelivo

    Create or improve skills, turn a conversation into reusable SKILL.md instructions, and validate their behavior.

    4.2k GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Official

    Searches, retrieves, and synthesizes official Google developer documentation across Google Cloud, AI/Gemini, Android, Chrome, Web, Flutter, Go, Firebase, and other Google developer platforms.

    21k GitHub stars~2k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Frb Android Emulator Prepare

    fzyzcjy/flutter_rust_bridge

    A skill your agent uses when preparing, installing, diagnosing, or explaining the host Android Emulator environment for flutterrustbridge local runtime validation, including Android SDK command-line…

    5.4k GitHub stars~2.1k tokensUpdated yesterday
    MobileAuto-check: notes
  • Stack Preview

    vicoa-ai/vicoa

    Run the whole Vicoa stack (Postgres, backend, realtime server, web dashboard) from the current checkout and publish it at one public tunnel URL, so a branch can be reviewed from another machine or…

    490 GitHub stars~1.8k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Claude Android Ninja

    Drjacky/claude-android-ninja

    Build and migrate Android apps with Kotlin, Jetpack Compose, MVVM, Hilt, Room 3 (KSP, SQLiteDriver, Flow/suspend DAOs), Navigation3, and multi-module Gradle.

    124 GitHub stars~5.2k tokensUpdated 8 days ago
    MobileAuto-check passed
  • Web3auth

    Web3Auth/web3auth-examples

    Integrates MetaMask Embedded Wallets (Web3Auth) for non-custodial wallets via social login or custom JWT (Firebase, Auth0, Cognito).

    144 GitHub stars~1.4k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed

More from mhmzdev/the-holy-quran-app

  • Docs Gardening

    mhmzdev/the-holy-quran-app

    Audit and maintain The Holy Qur'an app's knowledge base (AGENTS.md, .agents/rules/, docs/ OKF bundle) for staleness, broken cross-links, drift from code, and OKF structural issues.

    889 GitHub stars~1.1k tokensUpdated 27 days ago
    Auto-check passed
  • Plan

    mhmzdev/the-holy-quran-app

    Turn an idea or brainstorm into an actionable execution plan for The Holy Qur'an app with phases, file changes, and machine-checkable success criteria.

    889 GitHub stars~957 tokensUpdated 27 days ago
    Auto-check passed
  • Review

    mhmzdev/the-holy-quran-app

    Review The Holy Qur'an app code against the project's own conventions — layering (UI → Bloc → Repo → DataProvider), bloc anatomy, Provider tier, configs tokens, class widgets, Hive typeId safety…

    889 GitHub stars~907 tokensUpdated 27 days ago
    Auto-check passed
  • UI Design

    mhmzdev/the-holy-quran-app

    Design Flutter UI screens and widgets for The Holy Qur'an app.

    889 GitHub stars~1.2k tokensUpdated 27 days ago
    Auto-check passed
  • Grill Me

    mhmzdev/the-holy-quran-app

    Stress-test a plan, design, or idea for The Holy Qur'an app before implementation by interrogating it one question at a time — walking the decision tree, resolving dependencies, and surfacing every…

    889 GitHub stars~778 tokensUpdated 27 days ago
    Auto-check passed
  • Refine Approach

    mhmzdev/the-holy-quran-app

    Sharpen an existing brainstorm or execution plan for The Holy Qur'an app — score it for clarity, completeness, specificity, YAGNI, and scope, then improve it in place.

    889 GitHub stars~600 tokensUpdated 27 days ago
    Auto-check passed

Works with

Categories

Questions about Brainstorm

What does Brainstorm do?

Explore WHAT to build for The Holy Qur'an app through collaborative dialogue before any planning or code. Brainstorm is an agent skill from mhmzdev/the-holy-quran-app. Explore WHAT to build for The Holy Qur'an app through collaborative dialogue before any planning or code.

When should I use Brainstorm?

Brainstorm fits situations like: the user says brainstorm; think through this; what should we build; A request is fuzzy enough that jumping to a plan would guess at scope.

How do I install Brainstorm in Claude Code?

Run `npx skills add mhmzdev/the-holy-quran-app --skill brainstorm -a claude-code`. Or copy the skill folder (.agents/skills/brainstorm in mhmzdev/the-holy-quran-app) into .claude/skills/brainstorm in your project. Claude Code loads it when a task matches its description.

How do I install Brainstorm in Codex?

Run `npx skills add mhmzdev/the-holy-quran-app --skill brainstorm -a codex`. Or copy the skill folder (.agents/skills/brainstorm in mhmzdev/the-holy-quran-app) into .agents/skills/brainstorm in your project. Codex loads it when a task matches its description.

Can I use Brainstorm 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 mhmzdev/the-holy-quran-app --skill brainstorm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brainstorm, .gemini/skills/brainstorm, .github/skills/brainstorm and .opencode/skills/brainstorm in your project.

What does Brainstorm need to run?

SKILL.md names no scripts, command-line tools or credentials: Brainstorm is instructions for the agent only.

Does Brainstorm 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 Brainstorm 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 Brainstorm use?

Brainstorm 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 Brainstorm use?

About 845 tokens (SKILL.md is roughly 3.4k 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 Brainstorm?

Skills that share tags, products or a category with Brainstorm: Skill Creator (Chevey339/kelivo, 4.2k stars), Retrieving Developer Knowledge (google/skills, 21k stars), Frb Android Emulator Prepare (fzyzcjy/flutter_rust_bridge, 5.4k stars) and Stack Preview (vicoa-ai/vicoa, 490 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brainstorm?

mhmzdev (a GitHub user) maintains it in mhmzdev/the-holy-quran-app, which has 889 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 10, 2026.

Source: mhmzdev/the-holy-quran-app on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.