Individual skill
bananahub
Agent-native image workflow and optional prompt optimizer for `/bananahub` and generic agent image generation requests. Normalizes non-English prompts into English by default, generates or edits images across Gemini/Nano Banana, OpenAI GPT Image, chat-compatible routes, and Codex/host-native image tools when available, discovers or uses BananaHub templates, and captures successful multi-turn image iterations as reusable workflow templates. Explicit `/bananahub` requests execute the BananaHub workflow. Requests like "把刚才的调图流程沉淀成模板", "save this image workflow", or "capture workflow" should use the capture-workflow flow. Generic requests like "生成图片", "画一个", "create an image", or "edit this image" should load BananaHub as an optimization advisor: ask whether to optimize/template-route the prompt before generation, then continue with the user's chosen image channel.
SKILL.md
Source commit ffee193d135a0e84875a2073ed403c121014e393
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 11, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 113
- Repository last updated
- May 17, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
.gitignoreasset · 324 bytesBANANAHUB.mddoc · 12,252 bytesBANANAHUB.zh-CN.mddoc · 10,701 bytesCONTRIBUTING.mddoc · 819 bytesLICENSEasset · 1,079 bytesREADME.mddoc · 15,275 bytesREADME.zh-CN.mddoc · 14,462 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesSKILL.mdcore · 28,748 bytesagents/openai.yamlasset · 370 bytesdocs/assets/github/prompts/readme-hero-gpt-5-4.mddoc · 1,618 bytesdocs/assets/github/prompts/setup-guide-gpt-5-4.mddoc · 1,448 bytesdocs/assets/github/prompts/skill-architecture-gpt-5-4.mddoc · 1,465 bytesdocs/assets/github/prompts/user-flow-infographic-gpt-5-4.mddoc · 1,406 bytesdocs/assets/github/readme-hero-gpt-5-4.pngasset · 1,356,507 bytesdocs/assets/github/setup-guide-gpt-5-4.pngasset · 1,219,958 bytesdocs/assets/github/skill-architecture-gpt-5-4.pngasset · 1,074,969 bytesdocs/assets/github/user-flow-infographic-gpt-5-4.pngasset · 1,282,527 bytesreferences/capability-registry.mddoc · 7,424 bytesreferences/hub-discovery.mddoc · 5,261 bytesreferences/init-guide.mddoc · 10,262 bytesreferences/model-registry.jsonasset · 4,436 bytesreferences/official-sources.mddoc · 6,959 bytesreferences/optimization-pipeline.mddoc · 16,028 bytesreferences/profiles/3d.mddoc · 5,149 bytesreferences/profiles/concept-art.mddoc · 5,110 bytesreferences/profiles/diagram.mddoc · 7,313 bytesreferences/profiles/general.mddoc · 2,314 bytesreferences/profiles/illustration.mddoc · 8,977 bytesreferences/profiles/minimal.mddoc · 4,808 bytesreferences/profiles/photo.mddoc · 6,054 bytesreferences/profiles/product.mddoc · 4,738 bytesreferences/profiles/sticker.mddoc · 3,723 bytesreferences/profiles/text-heavy.mddoc · 6,029 bytesreferences/prompt-guide.mddoc · 14,247 bytesreferences/provider-init-design.zh-CN.mddoc · 10,488 bytesreferences/providers/gemini.mddoc · 1,604 bytesreferences/providers/openai-gpt-image.mddoc · 2,740 bytesreferences/template-format-spec.mddoc · 12,482 bytesreferences/template-system.mddoc · 20,855 bytesreferences/templates/LICENSEasset · 497 bytesreferences/templates/README.mddoc · 1,224 bytesreferences/templates/article-one-page-summary/README.mddoc · 1,362 bytesreferences/templates/article-one-page-summary/samples/sample-gpt-image-2-01.pngasset · 1,325,380 bytesreferences/templates/article-one-page-summary/template.mddoc · 7,126 bytesreferences/templates/background-replace-edit/README.mddoc · 1,519 bytesreferences/templates/background-replace-edit/samples/sample-gpt-image-2-01.pngasset · 1,348,714 bytesreferences/templates/background-replace-edit/template.mddoc · 5,281 bytesreferences/templates/info-diagram/README.mddoc · 1,319 bytesreferences/templates/info-diagram/samples/sample-3.1-flash-01.pngasset · 936,831 bytesreferences/templates/info-diagram/samples/sample-gpt-image-2-01.pngasset · 950,470 bytesreferences/templates/info-diagram/template.mddoc · 5,369 bytesreferences/templates/product-white-bg/README.mddoc · 1,572 bytesreferences/templates/product-white-bg/samples/sample-3.1-flash-01.pngasset · 640,968 bytesreferences/templates/product-white-bg/samples/sample-gpt-image-2-01.pngasset · 1,456,644 bytesreferences/templates/product-white-bg/template.mddoc · 5,943 bytesreferences/templates/repo-explainer-diagram/README.mddoc · 1,583 bytesreferences/templates/repo-explainer-diagram/samples/sample-3-pro-01.pngasset · 935,969 bytesreferences/templates/repo-explainer-diagram/samples/sample-3-pro-02.pngasset · 938,731 bytesreferences/templates/repo-explainer-diagram/samples/sample-gpt-image-2-01.pngasset · 1,012,602 bytesreferences/templates/repo-explainer-diagram/template.mddoc · 6,960 bytesscripts/bananahub.pyruns · 144,432 bytesscripts/config_store.pyruns · 20,129 bytesscripts/providers/__init__.pyruns · 47 bytesscripts/providers/chatgpt_compatible.pyruns · 6,191 bytesscripts/providers/common.pyruns · 4,792 bytesscripts/providers/gemini.pyruns · 2,450 bytesscripts/providers/openai_images.pyruns · 10,295 bytesscripts/runtime_config.pyruns · 9,306 bytesscripts/validate_templates.pyruns · 9,106 bytestests/test_chatgpt_compatible.pyruns · 1,658 bytestests/test_config_store.pyruns · 11,544 bytestests/test_generate_retry.pyruns · 6,366 bytestests/test_onboarding_config.pyruns · 11,729 bytestests/test_openai_images.pyruns · 19,274 bytestests/test_provider_common.pyruns · 1,998 bytestests/test_runtime_config.pyruns · 1,365 bytes
Read excerpt
# BananaHub
Generate or edit images from non-English or mixed-language requests inside one `/bananahub` workflow. GPT Image 2 through an OpenAI-compatible image endpoint is the default provider path; user-configured Gemini/Nano Banana, OpenAI official, Vertex, chat-compatible paths, and Codex/host-native image tools are preserved. BananaHub keeps prompt optimization, conservative enhancement, model fallback, image editing, template use, and BananaHub discovery in a single skill instead of splitting them across separate installs.
When BananaHub is loaded implicitly for a generic agent image request, act as a lightweight optimization layer first. Do not silently take over generation: ask whether the user wants BananaHub to optimize the prompt before the image tool runs, then respect the answer.
## Quick Start
- Install via Open Agent Skills: `npx skills add https://github.com/bananahub-ai/bananahub-skill --skill bananahub`
- Install in Claude Code directly: `claude skill install https://github.com/bananahub-ai/bananahub-skill`
- Run setup once: `/bananahub init`
- Test a host-native image tool such as Codex built-in image generation: `/bananahub test-host-imagegen`
- Generate from a natural-language request: `/bananahub 一只橘猫趴在键盘上打盹`
- Edit an image: `/bananahub edit 把背景换成海滩 --input photo.png`