ambler-init

name	ambler-init
description	Initializes a new Ambler state-machine project. Use this whenever a user wants to start a new Ambler project, bootstrap a state-machine app, or set up the Ambler folder structure — even if they just say "new project" or "set up ambler" or "create ambler folder".
metadata	{"author":"leandro","version":"2.1"}

Ambler Init

Install locally with: npx skills add argenkiwi/ambler-ts

This skill initializes a new Ambler project.

Template Files

Two core files are read from the skill's assets/ directory and written to the target.

Source	Writes to
ambler.ts	<target>/ambler.ts
deno.json	<target>/deno.json

---

Steps

1. Determine the target directory

• If the user provided a directory path, use it.
• If not, use the current directory (.).

2. Prepare the target directory

• If the directory does not exist, it will be created in step 3.

3. Create the directory structure

mkdir -p "<target>/nodes/tests" "<target>/walks" "<target>/specs" "<target>/utils"

4. Write template files

Read from the skill's assets/ directory and write to the target.

1. Read assets/ambler.ts → write to <target>/ambler.ts
2. Read assets/deno.json → write to <target>/deno.json

Read and write both files. Do not skip any.

5. Verify

Type-check the generated ambler.ts:

deno check "<target>/ambler.ts"

6. Report success

Initialized Ambler project in "<target>":
  ambler.ts
  deno.json
  nodes/
  walks/
  specs/
  utils/

Next steps:
  /ambler-walk   — create your first walk
  /ambler-node   — create a standalone node