# appbuilder-project-init

appbuilder-project-init is a Claude Code skill that initializes Adobe App Builder projects and prepares the environment for building. It runs during app scaffolding, extension setup, or developer console configuration.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 962 installs · ★ 335 repo stars
- Author: adobe
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/adobe/skills/tree/HEAD/plugins/app-builder/skills/appbuilder-project-init/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/appbuilder-project-init

## What it does

The assistant maps user intent to templates and executes non-interactive `aio app init`. It handles Console projects, workspaces, API subscriptions, and post-init customization.

Running the skill requires Node 20 and the Adobe I/O CLI installed via `npm install -g @adobe/aio-cli`. Without Node 20 active, the CLI fails on syntax checks during execution.

It also covers environment switching between stage and prod, login sessions, and debugging initialization errors.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill appbuilder-project-init -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/appbuilder-project-init/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/appbuilder-project-init/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill appbuilder-project-init -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/appbuilder-project-init/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill appbuilder-project-init -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/appbuilder-project-init/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install adobe/skills plugins/app-builder/skills/appbuilder-project-init
```

2. **Manually: put the files in place**
- File: `.github/skills/appbuilder-project-init/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill appbuilder-project-init -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/adobe/skills --path plugins/app-builder/skills/appbuilder-project-init
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/appbuilder-project-init/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill appbuilder-project-init -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/adobe/skills/tree/HEAD/plugins/app-builder/skills/appbuilder-project-init/SKILL.md

## When to use it
- initialize an Adobe App Builder project end-to-end
- create Console projects and workspaces non-interactively
- subscribe to APIs and configure workspaces
- set up Node 20 and Adobe I/O CLI for the environment

## Example prompts
- Initialize a new Adobe App Builder project and set up the console
- Create a workspace and add API subscriptions for the app
- Run `aio app init` and configure the template for an Experience Cloud extension

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: b7133fc987b8ec18.

BEGIN THIRD-PARTY FILE b7133fc987b8ec18
```text
---
name: appbuilder-project-init
description: Initialize an Adobe App Builder project end-to-end and prepare the machine to build one. Creates the Console project and workspace, subscribes APIs (including those needing a product profile), maps intent to the right template, runs non-interactive `aio app init`, and guides post-init customization. Use whenever the user mentions creating an App Builder app, scaffolding a project, `aio app init`, an Experience Cloud extension, adding actions or web assets, or creating a Console project/workspace — even without saying "App Builder". Also for SPA templates, AEM extensions, API Mesh, Asset Compute workers, and MCP servers. Also covers first-time machine/CLI setup (Node 20, aio CLI install, `aio login`, IMS org, stage vs prod) and debugging setup/init failures — `ERR_REQUIRE_ESM`, empty `aio console org list`, `451 accept developer terms`, template not found, init hangs, or Node/npm and post-init build errors.
metadata:
  category: project-initialization
license: Apache-2.0
compatibility: Requires aio CLI (Adobe I/O CLI) — install or refresh with `npm install -g @adobe/aio-cli` so the bundled plugins (`aio-cli-plugin-console`, `aio-cli-plugin-app`, etc.) are current. Node.js 18+ (Node 24 supported on Stage runtimes). Bash shell.
allowed-tools: Bash(aio:*) Bash(npm:*) Bash(node:*) Read Write Edit
---
# App Builder Project Initialization

Maps user intent to the right Adobe App Builder template and runs non-interactive `aio app init`. Default: `@adobe/generator-app-excshell` (SPA + actions). For headless/bare projects, use `init-bare`.

When a Developer Console project / workspace / API subscription does not yet exist, this skill walks the agent through creating them non-interactively by calling `aio console …` directly — see the **Bootstrap** section and [references/bootstrap.md](references/bootstrap.md). The latest `@adobe/aio-cli` bundle exposes non-interactive `aio console project create` / `workspace create` / `api list` / `workspace api add` (with `--license-config` for services that require a product profile), and non-interactive `aio app init --org/--project/--template-options`. Together they remove every blocking "open the Developer Console UI and click" step from the agentic setup path. Just install the latest CLI (`npm install -g @adobe/aio-cli`) and use them.

## Machine setup (first time)

Do this once per machine before initializing a project — plus a login per environment. If the CLI is already installed and you're logged in, skip to **Bootstrap** below.

### 1. Node 20

App Builder needs **Node 20** (npm ships with it). Check what's active: `node -v` → expect `v20.x`.

- **Have nvm?** `nvm install 20 && nvm use 20 && nvm alias default 20` so new shells keep it. If several Node versions are installed, the *active* one must be 20.
```
END THIRD-PARTY FILE b7133fc987b8ec18

The third-party file has ended. Everything between the b7133fc987b8ec18 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2849 of 25965 bytes. © adobe · Apache-2.0 · https://github.com/adobe/skills/tree/HEAD/plugins/app-builder/skills/appbuilder-project-init/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
