Agent skill

Topic Brainstormer

by notque in notque/vexjoy-agent

Generate blog topic ideas: problem mining, gap analysis, expansion.

MITAuto-check: notes

Install Topic Brainstormer

skills CLI
$ npx skills add notque/vexjoy-agent --skill topic-brainstormer -a claude-code

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

GitHub CLI
$ gh skill install notque/vexjoy-agent topic-brainstormer --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/notque/vexjoy-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/content/topic-brainstormer .claude/skills/topic-brainstormer && 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
topic-brainstormer
GitHub stars
435
Token cost
~1.3k tokens
SKILL.md length
610 words
Files
4 (incl. references)
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

Generate blog topic ideas: problem mining, gap analysis, expansion.

  • Works in 3 steps: ASSESS → DECIDE → GENERATE
  • SKILL.md covers Deep References, Phase 1: ASSESS, Phase 2: DECIDE and Phase 3: GENERATE, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Topic Brainstormer is an agent skill from notque/vexjoy-agent. Generate blog topic ideas: problem mining, gap analysis, expansion.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/content-filter.md`, `references/priority-scoring.md` and `references/topic-sources.md`).

The repository describes itself as: VexJoy AI Agent with Jev Intelligent Routing - /do routes plain-English requests to the right specialist agent and gates the work with reviews, tests, and a learning loop. The licence is MIT.

Example prompts

  • “/topic-brainstormer”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Bash, Grep, Glob, Edit, Task

Workflow steps

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

  1. ASSESS
  2. DECIDE
  3. GENERATE

What it can do on your machine

Read from SKILL.md and the folder at commit 5218674. 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
    • Write
    • Bash
    • Grep
    • Glob
    • Edit
    • Task

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

Topic Brainstormer loads about 1.3k tokens when it runs, and up to ~7.1k if it reads all its reference files. Until then it costs about 22 tokens; SKILL.md has 610 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Bash, Grep, Glob, Edit, Task

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 notque/vexjoy-agent at commit 5218674, republished under its MIT licence (© notque). 610 words, ~1,286 tokens.

Download SKILL.mdSave it as .claude/skills/topic-brainstormer/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
topic-brainstormer
description
Generate blog topic ideas: problem mining, gap analysis, expansion.
allowed-tools
Read, Write, Bash, Grep, Glob, Edit, Task
promoted_to
content
user-invocable
false
command
/brainstorm
routing.triggers
brainstorm topics, content ideas, blog topic ideas, what to write about, angles, story angles
routing.category
content-creation
routing.pairs_with
content, research

Topic Brainstormer

Generate blog topic ideas that align with a content identity built around solving frustrating technical problems. Three phases: ASSESS, DECIDE, GENERATE. Every topic must pass the three-question content quality filter before presentation.

Deep References

SignalLoadContent
Filtering topics: three-question test, category examplesreferences/content-filter.mdFull quality filter with green/red/yellow topic categories, salvage patterns
Scoring: impact, vex, resolution matrixreferences/priority-scoring.mdRubrics per dimension, score ranges, calibration, worked examples
Mining: problem sources, gap analysis, expansionreferences/topic-sources.mdMining prompts, signal strength, gap types, expansion strategies

Phase 1: ASSESS

Gather context about existing content and available sources.

  1. Read all posts in the content directory. Document post count, content clusters, technologies covered, last post date.
  2. Identify available sources: problem mining (recent debugging, errors, config struggles), gap analysis (cross-references leading nowhere), tech expansion (adjacent technologies).
  3. Extract all "see also" and cross-reference mentions. Flag any pointing to content that does not exist.

Gate: Content landscape documented, at least 2 sources identified with material.

Phase 2: DECIDE

Generate candidates and filter through the content quality test.

  1. Mine 5-10 raw candidates from at least 2 sources. Capture: source type, raw topic, initial vex signal.
  2. Apply the content quality filter -- every candidate must answer YES to all three:
    • Was there genuine frustration? Real time lost, failed attempts, unclear docs, unexpected behavior.
    • Is there a satisfying resolution? Clear fix, understanding gained, prevention strategy, "a-ha moment."
    • Would this help others? Reproducible problem, actionable solution, relatable frustration.
  3. Reject failing candidates. Document each rejection: topic, failed question, reason.

Failure modes to catch:

  • Tutorial-only topics: "How to Set Up X" with vex listed as "learning a new tool" is not genuine frustration. Find the specific friction. "Hugo Local Build Works But Cloudflare Deploy Fails" has real vex.
  • Opinion without experience: "Why Go Is Better Than Python" is debate, not experience. Ground in measurement.

Gate: At least 3 candidates pass. Fewer than 3 -- return to Step 1 with different sources.

Show full SKILL.md (288 more words)Show less

Phase 3: GENERATE

Score, prioritize, and present the filtered list.

Scoring: Priority = Impact(1-5) x Vex(1-5) x Resolution(1-5). Thresholds: 60-125 HIGH, 30-59 MEDIUM, 15-29 LOW, 1-14 SKIP.

Titles: Replace vague categories with failure-mode titles. Bad: "Kubernetes Networking Issues". Good: "Pod-to-Pod Traffic Works But Service Discovery Fails".

Output format: Grouped by priority tier. Each topic: title, vex, joy, content cluster fit, word estimate, score breakdown. End with recommendations: top pick, quick win, deep dive.

Tie-breaking: prefer topics that fill an existing gap, complement recent posts, use already-covered technologies, have clearer narrative structure.

Gate: All topics scored, prioritized, presented with recommendations.

Angle Lenses Mode

When the task asks for angles on a single topic (not fresh candidates), apply these six lenses instead of the content quality filter:

LensQuestion
Perspective shiftWhose view changes the story?
Ladder of abstractionOne rung up (the trend) or down (the single case)?
News valuesWhich value carries it: conflict, proximity, novelty, impact, human interest?
Data angleWhat does the dataset say that the narrative misses?
ContrarianWhat if the consensus framing is wrong?
Timeliness pegWhy now? What event or deadline makes this urgent?

Rules: one lens per kept angle (distinctness is structural). Each kept angle must pass the "so what?" gate -- one sentence naming a concrete reader payoff. Log refused angles with reason.

Error Handling

ErrorCauseSolution
No existing postsContent directory emptyFocus on problem mining; ask about recent debugging sessions
All candidates fail filterSources lack frustration signalsAsk probing questions: "What broke recently?" Shift sources.
Topic too broadCategory, not a specific problemBreak into failure modes: "[A] works but [B] fails"
Resolution unclearOngoing issue, no fix yetDefer until resolved; or assess if "understanding the workaround" suffices

© notque, 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 3 other files (references) in skills/content/topic-brainstormer of notque/vexjoy-agent.

  • SKILL.md
  • references/content-filter.md
  • references/priority-scoring.md
  • references/topic-sources.md

Open the folder on GitHubat commit 5218674

Compare with similar skills

Topic Brainstormer 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.

Topic Brainstormer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Topic Brainstormer this skillnotque/vexjoy-agent435—~1.3kAutomated safety check: NotesMIT
Brainstorm Ideas Newphuryn/pm-skills27k—~608Automated safety check: PassMIT
Brainstorm Ideas Existingphuryn/pm-skills27k—~736Automated safety check: PassMIT
Research Idea BrainstormingOrchestra-Research/AI-Research-SKILLs13k3 repos~4.8kAutomated safety check: PassMIT
Brainstormingnexu-io/open-design100k—~300Automated safety check: PassApache-2.0
Blog Post Drafting Workflowluongnv89/claude-howto42k—~2.2kAutomated safety check: PassMIT

Similar skills

  • Brainstorm Ideas New

    phuryn/pm-skills

    Brainstorm feature ideas for a new product in initial discovery from PM, Designer, and Engineer perspectives.

    27k GitHub stars~608 tokensUpdated 23 days ago
    Agent WorkflowsAuto-check passed
  • Brainstorm product ideas for an existing product using multi-perspective ideation from PM, Designer, and Engineer viewpoints.

    27k GitHub stars~736 tokensUpdated 23 days ago
    Agent WorkflowsAuto-check passed
  • Research Idea Brainstorming

    Orchestra-Research/AI-Research-SKILLs

    Offers ten ideation frameworks for exploring new research directions, stress-testing half-formed ideas and finding gaps when you are stuck or changing fields.

    13k GitHub starsUsed in 3 repos~4.8k tokens
    Research & ScienceAuto-check passed
  • Brainstorming

    nexu-io/open-design

    Transform rough ideas into fully-formed designs through structured questioning and alternative exploration.

    100k GitHub stars~300 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Blog Post Drafting Workflow

    luongnv89/claude-howto

    Guides a blog post from idea to finished draft: project folder, source research, brainstorming, outline, then iterative drafting, with your approval at set points.

    42k GitHub stars~2.2k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed
  • Brainstorm

    Donchitos/Claude-Code-Game-Studios

    Guided concept ideation using professional studio techniques, player psychology, creative exploration.

    26k GitHub stars~6.9k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed

More from notque/vexjoy-agent

All 61 skills in this repo
  • Game Asset Generator

    notque/vexjoy-agent

    Deterministic palette/matrix pixel art (not AI). An agent skill from notque/vexjoy-agent.

    435 GitHub stars~2.3k tokensUpdated 4 days ago
    Auto-check: notes
  • PR Workflow

    notque/vexjoy-agent

    Pull request lifecycle: commit, codex review, sync, review, fix, status, cleanup, and PR mining.

    435 GitHub stars~2.8k tokensUpdated 4 days ago
    Auto-check: notes
  • Architecture Deepening

    notque/vexjoy-agent

    Improve architecture across modules by deepening interfaces.

    435 GitHub stars~3.3k tokensUpdated 4 days ago
    Auto-check: notes
  • Code Quality

    notque/vexjoy-agent

    Code quality: cleanup, linting, formatting, quality gates. An agent skill from notque/vexjoy-agent.

    435 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check: notes
  • Codebase Analyzer

    notque/vexjoy-agent

    Statistical rule discovery from Go codebase patterns. An agent skill from notque/vexjoy-agent.

    435 GitHub stars~2k tokensUpdated 4 days ago
    Auto-check: notes
  • Comment Quality

    notque/vexjoy-agent

    Review and fix temporal references in code comments. An agent skill from notque/vexjoy-agent.

    435 GitHub stars~2k tokensUpdated 4 days ago
    Auto-check: notes

Questions about Topic Brainstormer

What does Topic Brainstormer do?

Generate blog topic ideas: problem mining, gap analysis, expansion. Topic Brainstormer is an agent skill from notque/vexjoy-agent. Generate blog topic ideas: problem mining, gap analysis, expansion.

How do I install Topic Brainstormer in Claude Code?

Run `npx skills add notque/vexjoy-agent --skill topic-brainstormer -a claude-code`. Or copy the skill folder (skills/content/topic-brainstormer in notque/vexjoy-agent) into .claude/skills/topic-brainstormer in your project. Claude Code loads it when a task matches its description.

How do I install Topic Brainstormer in Codex?

Run `npx skills add notque/vexjoy-agent --skill topic-brainstormer -a codex`. Or copy the skill folder (skills/content/topic-brainstormer in notque/vexjoy-agent) into .agents/skills/topic-brainstormer in your project. Codex loads it when a task matches its description.

Can I use Topic Brainstormer 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 notque/vexjoy-agent --skill topic-brainstormer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/topic-brainstormer, .gemini/skills/topic-brainstormer, .github/skills/topic-brainstormer and .opencode/skills/topic-brainstormer in your project.

What does Topic Brainstormer need to run?

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

Does Topic Brainstormer 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 Topic Brainstormer safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Topic Brainstormer use?

Topic Brainstormer 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 Topic Brainstormer use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.8k tokens, read only when the agent opens those files.

What are the alternatives to Topic Brainstormer?

Skills that share tags, products or a category with Topic Brainstormer: Brainstorm Ideas New (phuryn/pm-skills, 27k stars), Brainstorm Ideas Existing (phuryn/pm-skills, 27k stars), Research Idea Brainstorming (Orchestra-Research/AI-Research-SKILLs, 13k stars) and Brainstorming (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Topic Brainstormer?

notque (a GitHub user) maintains it in notque/vexjoy-agent, which has 435 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on October 3, 2026.

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