READ BEFORE INSTALL This skill follows the bundled prompt workflow reference exactly:

Collect the user's base business prompt
Add the aicade platform integration requirements from section 3.1
Assemble one final integrated prompt like section 3.2 READ BEFORE INSTALL

aicade-app-builder

Use this skill when you want to generate a final AI prompt for an aicade app and you want the result to match the bundled documented workflow.

Core Principle

This skill does not invent a new requirement structure.

It uses:

3.1 as the required input model
3.2 as the target output style

That means:

the user provides a base business prompt
the user provides or accepts the aicade platform additions
the skill assembles the final integrated prompt

Quick Start

node {baseDir}/scripts/check-aicade-env.mjs --mode all --cwd /path/to/project
node {baseDir}/scripts/save-aicade-env.mjs --cwd /path/to/project --set AICADE_API_KEY=... --set AICADE_API_SECRET_KEY=...

node {baseDir}/scripts/build-aicade-prompt.mjs \
  --spec {baseDir}/assets/app-spec.template.json \
  --lang en

Recommended Workflow

1. Confirm Platform Access First

Before collecting the final prompt inputs, first tell the user to open:

https://www.aicadegalaxy.com/

The user should:

connect their wallet
click Launch App
enter the Dapp Management page
click the Show App key button
read the API key information from the popup

Only after completing that flow should the skill continue to collect the core AICADE environment variables required for integration:

AICADE_API_KEY
AICADE_API_SECRET_KEY

Also keep:

AICADE_API_URL

Treat AICADE_API_URL = VITE_AICADE_API_URL. Its default value is https://aicadegalaxy.com/v1.

Keep this access check separate from the upload step. The official scaffold upload flow does not read these access variable names directly from upload.js.

On the first use of this skill in a project, check the local environment first for these platform-access variables. If any of them are missing, ask the user for the missing values one by one instead of asking for all values again at once. After each value is provided, save it into the project's local .env file immediately. If AICADE_API_URL is missing, use the default value and save it automatically.

Recommended check command:

node {baseDir}/scripts/check-aicade-env.mjs --mode access --cwd /path/to/project

Recommended save command:

node {baseDir}/scripts/save-aicade-env.mjs --cwd /path/to/project --set AICADE_API_KEY=...

Standard follow-up pattern:

Run the check command.
If all required values are present, tell the user they were found locally and ask for confirmation to reuse them.
If some values are missing, ask only for the first missing value.
After the user provides it, save it into .env, then move to the next missing value until the access set is complete.
If AICADE_API_URL is not set, write the default https://aicadegalaxy.com/v1 into .env automatically.

Example:

I found AICADE_API_KEY locally.
AICADE_API_SECRET_KEY is missing. Please provide AICADE_API_SECRET_KEY.
AICADE_API_URL is not set locally, so I will use the default https://aicadegalaxy.com/v1 and save it for this project.

2. Check Tech Stack Compatibility First

Before entering implementation or prompt assembly, first read:

https://github.com/aicade-galaxy/aicade-ts-bootstrap/blob/main/README.md

The target app or game environment must conform to the technical stack and integration conventions described there.

If the current project does not match that technical stack, do not proceed silently. You must stop and confirm with the user using only these two options:

Use AI to automatically reimplement the app in the required technical stack
Wait for the user to regenerate it manually, then continue

Do not introduce a third option in this decision point.

If the user chooses option 1, start from the official scaffold directly:

https://github.com/aicade-galaxy/aicade-ts-bootstrap

Use that repository as the project scaffold for the reimplementation. Do not rebuild the scaffold structure from scratch. The scaffold already includes the official upload script and upload command.

When migrating from a non-matching project into the scaffold:

Inspect the old project and extract the business goal, page structure, interaction rules, scoring or reward logic, and asset needs.
Rewrite that information into the skill's 3.1-shaped input.
Rebuild the app on top of aicade-ts-bootstrap instead of patching the old structure in place.
Use the scaffold's existing upload.js and npm commands as-is.

3. Read Before Prompt Assembly

Read the bundled references first:

references/sdk-capabilities.md
references/prompt-workflow.md

4. Prepare Input In The `3.1` Shape

The user input should contain two parts:

Base business prompt
Platform integration additions

The platform additions should cover the same kind of information highlighted in 3.1, such as:

SDK initialization and invocation requirements
scaffold document paths that the implementation model should read
local storage replacement strategy
wallet address display
account and balance display
ticket or payment access flow
score, points, token, AI chat, NFT, or market-related capabilities when needed
iframe sandbox compatibility constraints

After the README tech stack check passes, confirm integration in 3 layers:

Base requirements: must be added
Compatibility requirements: must be added
Extension SDK modules: ask the user whether each one should be added

Base requirements and compatibility requirements are mandatory and should not be skipped.

Extension SDK modules must be confirmed with the user before they are added to the final prompt.

If an extension module has configurable parameters, confirm those parameter values explicitly before prompt assembly. For example:

if AicadeCurrency exchange is enabled, confirm the exchange ratio
confirm the daily cap if the business requires it
confirm the exchange trigger timing

Common SDK Capabilities

The platform can expose multiple SDK modules. Choose only the real modules your app actually needs:

Application: app metadata and lifecycle
Ticket: access gate, subscription, or play/payment flow
AppScore: score and leaderboard
AicadeCurrency: point or platform currency operations
AIChat: AI chat session and messages
AICoinMarket: market assistant and streaming messages
Token: token balance and swap flow
NftOwner: NFT ownership and avatar
LocalStorageTools: app-scoped storage instead of browser localStorage

Recommended confirmation order:

mandatory base requirements
mandatory compatibility requirements
selected SDK modules
optional extension modules

5. Generate The Final Prompt

Run:

node {baseDir}/scripts/build-aicade-prompt.mjs --spec /path/to/spec.json --lang en

The script will output one final prompt that:

keeps the user's base business prompt structure
appends the aicade platform integration block
keeps technical requirements and output requirements
reads like the final integrated prompt shown in 3.2

6. Use The Prompt In Your IDE

Paste the generated prompt into Cursor, VS Code, or another AI IDE assistant.

7. Review Generated Code

Check these items before running the app:

SDK initialization order is correct
No unsupported SDK methods are called
LocalStorageTools replaces localStorage
Wallet address, balance, score, token, chat, or NFT UI is shown only when the selected SDK capabilities require it
Exchange rules are enforced only when the app explicitly enables exchange-related capabilities
iframe-safe communication and storage strategies are used instead of same-origin browser assumptions
SecurityError, blocked frame access, and storage access failures are handled gracefully
Error handling exists around async SDK calls

8. Confirm Upload Variables Every Time

On the first use of this skill in a project, check the local environment first for the scaffold upload credentials listed below. If a value is already present locally, confirm and reuse it. If a value is missing, ask the user only for that missing value, one at a time. Do not ask again for VITE_AICADE_API_KEY or VITE_AICADE_API_SECRET_KEY when AICADE_API_KEY and AICADE_API_SECRET_KEY have already been saved, because they should be mirrored into .env.

Recommended check command:

node {baseDir}/scripts/check-aicade-env.mjs --mode upload --cwd /path/to/project

Recommended save command:

node {baseDir}/scripts/save-aicade-env.mjs --cwd /path/to/project --set VITE_AICADE_API_URL=...

Standard follow-up pattern:

Run the check command.
Reuse any values already found locally.
Treat AICADE_API_KEY = VITE_AICADE_API_KEY and AICADE_API_SECRET_KEY = VITE_AICADE_API_SECRET_KEY.
Ask only for the first missing required upload value.
Save every newly provided value into .env immediately.
VITE_AICADE_API_UPLOAD uses the scaffold default and should not be requested unless the user explicitly wants to override it.
AICADE_API_URL = VITE_AICADE_API_URL, and the default should be https://aicadegalaxy.com/v1.
Ask for a custom API URL only when the user explicitly wants to override that default.
Before the actual upload step, restate the resolved upload variables together with their current values and ask for final confirmation.

Example:

I already have AICADE_API_KEY locally, so I will reuse it as VITE_AICADE_API_KEY as well.
I already have AICADE_API_SECRET_KEY locally, so I will reuse it as VITE_AICADE_API_SECRET_KEY as well.
I will use the default AICADE_API_URL / VITE_AICADE_API_URL value: https://aicadegalaxy.com/v1.
Final upload confirmation: VITE_AICADE_API_KEY=..., VITE_AICADE_API_SECRET_KEY=..., VITE_AICADE_API_URL=https://aicadegalaxy.com/v1. Please confirm whether I should continue with these values.

Before every upload, reconfirm the required values used by the scaffold upload.js flow:

AICADE_API_KEY / VITE_AICADE_API_KEY / DAPP_KEY
AICADE_API_SECRET_KEY / VITE_AICADE_API_SECRET_KEY / DAPP_SECRET_KEY

Optional overrides:

VITE_AICADE_API_UPLOAD or UPLOAD_URL only when the default upload URL must be replaced
AICADE_API_URL / VITE_AICADE_API_URL only when the default base https://aicadegalaxy.com/v1 must be customized

Do this every time before upload, even if they were confirmed earlier in the same project.

9. Build And Upload

For a new project, copy upload.js directly from:

https://github.com/aicade-galaxy/aicade-ts-bootstrap/blob/main/upload.js

Do not rewrite upload.js. Do not regenerate its logic from scratch. Use the official upstream file unless the user explicitly asks to compare or refresh it from the source repository.

npm install
npm run dev
npm run upload

Script Input Spec

The prompt builder accepts a JSON file like this:

{
  "roleSetup": "You are a senior full-stack product engineer.",
  "projectName": "AI Event Assistant",
  "projectGoal": "Build an aicade application for event registration, check-in, and reward redemption.",
  "basePromptSections": [
    {
      "title": "Core Business Requirements",
      "items": [
        "Put your original business prompt for the AI here."
      ]
    }
  ],
  "platformIntegration": {
    "scaffoldReadmePath": "README.md",
    "scaffoldSdkDocPath": "doc/README.md",
    "scaffoldAppGuidePath": "doc/AICreateApplication-EN.md",
    "sdkAlreadyIntegrated": true,
    "requiredSdkModules": [
      "Application",
      "LocalStorageTools"
    ],
    "baseRequirements": [
      "Initialize AicadeSDK in the correct order with init(...), waitForReady(), and getModule(...)."
    ],
    "compatibilityRequirements": [
      "Respect iframe sandbox restrictions and opaque-origin limitations.",
      "Replace browser localStorage usage with LocalStorageTools."
    ],
    "replaceLocalStorageWith": "LocalStorageTools",
    "showWalletAddress": true,
    "showPointBalance": false,
    "pointBalanceLabel": "Points",
    "exchange": {
      "enabled": false,
      "ratio": "100:1",
      "dailyLimit": "100 Aicade Points",
      "trigger": "On each business settlement"
    }
  },
  "technicalRequirements": [
    "Generate within the current project environment."
  ],
  "outputRequirements": [
    "Output complete runnable code."
  ]
}

Use:

{baseDir}/assets/app-spec.template.json for the minimal 3.1-style input
{baseDir}/assets/app-spec.example.json for a fuller example

Files Included

scripts/build-aicade-prompt.mjs
scripts/check-aicade-env.mjs
scripts/save-aicade-env.mjs
assets/app-spec.template.json
assets/app-spec.example.json
references/sdk-capabilities.md
references/prompt-workflow.md

Security And Permissions

This skill:

runs a local Node.js script
reads a local JSON spec file
prints a generated prompt to stdout

This skill does not:

modify source code automatically
upload anything by itself
invoke the model autonomously

Notes

The input model is based on 3.1
The output format is intentionally shaped like 3.2
Ask about platform app access before discussing env vars
Check README tech stack compatibility before implementation
If the stack does not match, only offer the two allowed choices
Reconfirm the real upload.js environment variables before every upload
For new projects, copy upload.js from the official aicade-ts-bootstrap repository instead of rewriting it
If the docs change, update this skill accordingly