diff --git a/codex/makers-cli.md b/codex/makers-cli.md
index 90437ca..b570ff7 100644
--- a/codex/makers-cli.md
+++ b/codex/makers-cli.md
@@ -69,3 +69,22 @@ edgeone makers deploy
 edgeone makers env set WSA_API_KEY "your-key"
 edgeone makers env set SUPABASE_URL "https://xxx.supabase.co"
 ```
+
+## Typed config (`edgeone.config.ts`)
+
+Write `edgeone.config.ts` with `defineConfig` from `@edgeone/types/config`:
+
+```ts
+// edgeone.config.ts
+import { defineConfig } from '@edgeone/types/config';
+
+export default defineConfig({
+  outputDirectory: 'dist',
+  buildCommand: 'npm run build',
+  nodeVersion: '20',
+});
+```
+
+`edgeone compile` transpiles `edgeone.config.ts` → `edgeone.json`; `edgeone schema`
+writes `edgeone.schema.json` locally for IDE validation. The CLI is self-contained —
+no need to install `@edgeone/types` just to run these commands.
diff --git a/cursor/rules/makers-cli.mdc b/cursor/rules/makers-cli.mdc
index 90437ca..b570ff7 100644
--- a/cursor/rules/makers-cli.mdc
+++ b/cursor/rules/makers-cli.mdc
@@ -69,3 +69,22 @@ edgeone makers deploy
 edgeone makers env set WSA_API_KEY "your-key"
 edgeone makers env set SUPABASE_URL "https://xxx.supabase.co"
 ```
+
+## Typed config (`edgeone.config.ts`)
+
+Write `edgeone.config.ts` with `defineConfig` from `@edgeone/types/config`:
+
+```ts
+// edgeone.config.ts
+import { defineConfig } from '@edgeone/types/config';
+
+export default defineConfig({
+  outputDirectory: 'dist',
+  buildCommand: 'npm run build',
+  nodeVersion: '20',
+});
+```
+
+`edgeone compile` transpiles `edgeone.config.ts` → `edgeone.json`; `edgeone schema`
+writes `edgeone.schema.json` locally for IDE validation. The CLI is self-contained —
+no need to install `@edgeone/types` just to run these commands.
diff --git a/skills/edgeone-makers-tools/references/makers-cli/SKILL.md b/skills/edgeone-makers-tools/references/makers-cli/SKILL.md
index 90437ca..b570ff7 100644
--- a/skills/edgeone-makers-tools/references/makers-cli/SKILL.md
+++ b/skills/edgeone-makers-tools/references/makers-cli/SKILL.md
@@ -69,3 +69,22 @@ edgeone makers deploy
 edgeone makers env set WSA_API_KEY "your-key"
 edgeone makers env set SUPABASE_URL "https://xxx.supabase.co"
 ```
+
+## Typed config (`edgeone.config.ts`)
+
+Write `edgeone.config.ts` with `defineConfig` from `@edgeone/types/config`:
+
+```ts
+// edgeone.config.ts
+import { defineConfig } from '@edgeone/types/config';
+
+export default defineConfig({
+  outputDirectory: 'dist',
+  buildCommand: 'npm run build',
+  nodeVersion: '20',
+});
+```
+
+`edgeone compile` transpiles `edgeone.config.ts` → `edgeone.json`; `edgeone schema`
+writes `edgeone.schema.json` locally for IDE validation. The CLI is self-contained —
+no need to install `@edgeone/types` just to run these commands.