Use before scaffolding a bwai project — runs the full startup-goal workflow then recommends the right boilerplate and outputs the exact bwai new command to run.

MITAuto-check passedDevelopment

Install Bwai Advisor

skills CLI
$ npx skills add johnku2011/boilerplates-with-ai-skills --skill bwai-advisor -a claude-code

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

GitHub CLI
$ gh skill install johnku2011/boilerplates-with-ai-skills bwai-advisor --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/johnku2011/boilerplates-with-ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/shared/skills/bwai-advisor .claude/skills/bwai-advisor && 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
bwai-advisor
GitHub stars
240
Token cost
~1.2k tokens
SKILL.md length
608 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Use before scaffolding a bwai project — runs the full startup-goal workflow then recommends the right boilerplate and outputs the exact bwai new command to run.

  • Works in 3 steps: Read the file before asking intake… → Skip questions the document already… → Only ask about missing or ambiguous…
  • Tasks that involve Project scaffolding
  • SKILL.md covers Required Companion Skill, Mode Choice, Idea Document Input and How to Run (Full mode), plus 3 more sections
  • Calls npx

What it does

Bwai Advisor is an agent skill from johnku2011/boilerplates-with-ai-skills. Use before scaffolding a bwai project — runs the full startup-goal workflow then recommends the right boilerplate and outputs the exact bwai new command to run.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: bwai CLI + agent with skill install access

It sits in Development, covering Project scaffolding. The licence is MIT.

When your agent uses it

  • Tasks that involve Project scaffolding

Example prompts

  • “/bwai-advisor”

Requirements

  • Python 3
  • Node.js
  • Compatibility (from SKILL.md): bwai CLI + agent with skill install access

Workflow steps

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

  1. Read the file before asking intake questions.
  2. Skip questions the document already answers clearly.
  3. Only ask about missing or ambiguous high-risk unknowns.

What it can do on your machine

Read from SKILL.md and the folder at commit 475dc6a. 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

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    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.

  • Compatibility

    bwai CLI + agent with skill install access

    From compatibility in the SKILL.md frontmatter.

Context cost

Bwai Advisor loads about 1.2k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 608 words of instructions outside code blocks.

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

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 johnku2011/boilerplates-with-ai-skills at commit 475dc6a, republished under its MIT licence (© johnku2011). 608 words, ~1,241 tokens.

Download SKILL.mdSave it as .claude/skills/bwai-advisor/SKILL.md (or your agent's skills folder).
name
bwai-advisor
description
Use before scaffolding a bwai project — runs the full startup-goal workflow then recommends the right boilerplate and outputs the exact bwai new command to run.
compatibility
bwai CLI + agent with skill install access
license
MIT
metadata.suite
advisor

bwai Advisor

Use this skill when you have a product idea but haven't scaffolded yet. It runs the full startup-goal workflow to shape your goal, then maps the output to the right bwai boilerplate and gives you the exact command to run.

Required Companion Skill

  • startup-goal — runs first; the full intake loop, role subagents, and decision log are all startup-goal's responsibility. bwai-advisor adds only the final scaffold recommendation on top.

If startup-goal is unavailable, stop and tell the user to install both:

bash
npx bwai-cli install-skill bwai-advisor --global

That command installs bwai-advisor and its companion startup-goal into the user's global agent skill directories.

Mode Choice

At the start, pick a mode (ask once if unclear):

ModeWhenWhat you run
Full (default)Idea is fuzzy; need PRD + rolesFull startup-goal, then scaffold recommendation
Quick pickStack/product type is already clear, or user asks only for a boilerplateSkip role bench; recommend from signals + catalog

Also use Quick pick when the user says the idea doc is an approved brief.

Idea Document Input

If the user points at a markdown (or other) idea brief — via @file.md, a path, or "read this doc" — treat that file as the starting hypothesis:

  1. Read the file before asking intake questions.
  2. Skip questions the document already answers clearly.
  3. Only ask about missing or ambiguous high-risk unknowns.

How to Run (Full mode)

  1. Follow the startup-goal skill — intake loop, role subagents, decision log.
  2. Once the decision log is ready, continue to Scaffold Recommendation.

Scaffold Recommendation

After the brief is ready, choose a boilerplate using live catalog data when available, then fall back to the table below.

Prefer live catalog

If the bwai / bwai-cli CLI is available, run:

bash
bwai list-boilerplates

Use the printed names, stacks, and descriptions to pick the best match for the goal. Prefer an exact catalog name over inventing a new one.

Show full SKILL.md (305 more words)Show less
Fallback mapping (when CLI is unavailable)

Pick the first row that matches:

If the goal is…Boilerplate
An AI product — chat, tools, structured LLM outputs on Next.jsnextjs-ai-app
A web product that needs a UI — React, Next.js, full-stack (no AI SDK)nextjs-app
A REST or HTTP API in Node where raw performance mattersfastify-api
A REST or HTTP API in Node where middleware and ecosystem matterexpress-api
A Python service, data pipeline, ML endpoint, or FastAPI projectpython-service
A mobile app targeting iOS and/or Androidreact-native-app
A CLI tool, background worker, cron job, or pure Node servicenode-service

If no row matches: say so explicitly. Name the closest boilerplate and explain what it covers and what it doesn't. Do not silently force a bad fit.

Confidence

Always state confidence for the primary pick:

ConfidenceMeaning
HighStack and product shape match one boilerplate clearly
MediumTwo boilerplates could work; primary is a judgment call
LowPartial fit or missing catalog option; say what is missing

When confidence is Medium or Low, always include an Alternative with when to prefer it (e.g. API-only first vs full-stack UI).

Output Format

Append this block at the end of the decision log (or after the quick-pick summary):


Mode: Full | Quick pick

Boilerplate: <name> — <one-line reason tied to the goal>

Confidence: High | Medium | Low — <one-line why>

Alternative: <name or "none"> — <when to prefer this>

Command:

bash
bwai new <boilerplate-name> ./<project-folder> --agents claude,cursor

After scaffold, continue with:

text
cd <project-folder>
$founding-engineer  implement the first slice from the decision log
$qa-lead            verify acceptance before calling the slice done

Keep fresh:

bash
bwai sync-upstream   # pull latest omni-skills content into the project

Once scaffolded, the project includes $startup-goal, $founding-engineer, $qa-lead, $cto, and $product-manager — pick up where you left off using those skills inside your new project.


Maintenance Note

The fallback mapping table is a last resort. Prefer bwai list-boilerplates. Update the table when the catalog changes and the CLI is not the primary source. The startup-goal workflow stays in the startup-goal skill and updates via bwai sync-upstream / global reinstall.

© johnku2011, 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 shared/skills/bwai-advisor of johnku2011/boilerplates-with-ai-skills.

Open the folder on GitHubat commit 475dc6a

Compare with similar skills

Bwai Advisor 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.

Bwai Advisor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bwai Advisor this skilljohnku2011/boilerplates-with-ai-skills240—~1.2kAutomated safety check: PassMIT
Nx Generatenomcopter/react-mosaic4.8k7 repos~1.9kAutomated safety check: PassCustom licence
PonytailDavidObando/gsharp5648 repos~1.7kAutomated safety check: PassMIT
Run Nx Generatornrwl/nx29k2 repos~592Automated safety check: NotesMIT
Conductor Setupgemini-cli-extensions/conductor3.8k—~4.2kAutomated safety check: PassApache-2.0
Mirage VFS Adapter Authoringstrukto-ai/mirage3.7k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Nx Generate

    nomcopter/react-mosaic

    Generate code using nx generators. An agent skill from nomcopter/react-mosaic.

    4.8k GitHub starsUsed in 7 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Ponytail

    DavidObando/gsharp

    Forces the laziest solution that actually works, simplest, shortest, most minimal.

    564 GitHub starsUsed in 8 repos~1.7k tokens
    DevelopmentAuto-check passed
  • Run Nx generators with prioritization for workspace-plugin generators.

    29k GitHub starsUsed in 2 repos~592 tokens
    DevelopmentAuto-check: notes
  • Conductor Setup

    gemini-cli-extensions/conductor

    Scaffolds the project and sets up the Conductor environment.

    3.8k GitHub stars~4.2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Builds or extends a custom Mirage virtual filesystem adapter for an API, database, object store or app data, with a working mount configuration and filesystem tests.

    3.7k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Enforces this repository's TypeScript backend module architecture under server/: feature folders, barrel exports, and where shared types and utilities belong.

    14k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from johnku2011/boilerplates-with-ai-skills

All 18 skills in this repo
  • Project Security

    johnku2011/boilerplates-with-ai-skills

    A skill your agent uses when reviewing security-sensitive code paths — check auth, secrets, input validation, dependency risk, and data exposure before shipping.

    240 GitHub stars~650 tokensUpdated 1 mo ago
    Auto-check passed
  • Code Review

    johnku2011/boilerplates-with-ai-skills

    A skill your agent uses when reviewing a diff or pull request — check correctness, tests, readability, security, and server/client boundaries before approving.

    240 GitHub stars~708 tokensUpdated 1 mo ago
    Auto-check passed
  • Python API Design

    johnku2011/boilerplates-with-ai-skills

    A skill your agent uses when adding or changing FastAPI routes, dependencies, or tests in this Python service — keep endpoints typed, validated, and covered by pytest.

    240 GitHub stars~449 tokensUpdated 1 mo ago
    Auto-check passed
  • Deploy Vercel

    johnku2011/boilerplates-with-ai-skills

    A skill your agent uses when deploying or configuring this project on Vercel — env vars, build settings, serverless limits, and production checks for Next.js or Express.

    240 GitHub stars~660 tokensUpdated 1 mo ago
    Auto-check: notes
  • Express API Design

    johnku2011/boilerplates-with-ai-skills

    A skill your agent uses when adding or changing routes, middleware, or error handling in this Express.js API, to keep endpoints consistent, validated, and testable.

    240 GitHub stars~575 tokensUpdated 1 mo ago
    Auto-check passed
  • Nextjs App Router

    johnku2011/boilerplates-with-ai-skills

    A skill your agent uses when adding pages, layouts, route handlers, or data fetching in this Next.js App Router project, to follow server-first conventions correctly.

    240 GitHub stars~587 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Bwai Advisor

What does Bwai Advisor do?

Use before scaffolding a bwai project — runs the full startup-goal workflow then recommends the right boilerplate and outputs the exact bwai new command to run. Bwai Advisor is an agent skill from johnku2011/boilerplates-with-ai-skills. Use before scaffolding a bwai project — runs the full startup-goal workflow then recommends the right boilerplate and outputs the exact bwai new command to run.

When should I use Bwai Advisor?

Bwai Advisor fits situations like: tasks that involve Project scaffolding.

How do I install Bwai Advisor in Claude Code?

Run `npx skills add johnku2011/boilerplates-with-ai-skills --skill bwai-advisor -a claude-code`. Or copy the skill folder (shared/skills/bwai-advisor in johnku2011/boilerplates-with-ai-skills) into .claude/skills/bwai-advisor in your project. Claude Code loads it when a task matches its description.

How do I install Bwai Advisor in Codex?

Run `npx skills add johnku2011/boilerplates-with-ai-skills --skill bwai-advisor -a codex`. Or copy the skill folder (shared/skills/bwai-advisor in johnku2011/boilerplates-with-ai-skills) into .agents/skills/bwai-advisor in your project. Codex loads it when a task matches its description.

Can I use Bwai Advisor 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 johnku2011/boilerplates-with-ai-skills --skill bwai-advisor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bwai-advisor, .gemini/skills/bwai-advisor, .github/skills/bwai-advisor and .opencode/skills/bwai-advisor in your project.

What does Bwai Advisor need to run?

Going by SKILL.md and its folder, Bwai Advisor needs the command-line tools its instructions call (npx). Our summary lists: Python 3; Node.js. Compatibility (from SKILL.md): bwai CLI + agent with skill install access.

Does Bwai Advisor access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Bwai Advisor 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 Bwai Advisor use?

Bwai Advisor is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bwai Advisor use?

About 1.2k tokens (SKILL.md is roughly 5k 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 Bwai Advisor?

Skills that share tags, products or a category with Bwai Advisor: Nx Generate (nomcopter/react-mosaic, 4.8k stars), Ponytail (DavidObando/gsharp, 564 stars), Run Nx Generator (nrwl/nx, 29k stars) and Conductor Setup (gemini-cli-extensions/conductor, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bwai Advisor?

johnku2011 (a GitHub user) maintains it in johnku2011/boilerplates-with-ai-skills, which has 240 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on August 24, 2026.

Source: johnku2011/boilerplates-with-ai-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.