# edgeone-makers-recipes

edgeone-makers-recipes — a skill for Claude Code that generates project structures and templates for EdgeOne Makers apps.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 249 installs · ★ 1839 repo stars
- Author: edgeone
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/TencentEdgeOne/edgeone-makers-tools/tree/HEAD/skills/edgeone-makers-tools/references/makers-recipes/SKILL.md
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/edgeone-makers-recipes

## What it does

The skill guides the agent on file organization, endpoint naming, and storage setup when scaffolding EdgeOne Makers applications. Templates cover static sites, backend functions, and projects utilizing Blob storage. Rules define the correct sequence for writing files and starting the local server.

The platform lacks a built-in database, so record persistence relies on `@edgeone/pages-blob`. AI-powered projects require a `.env.example` file in the root containing gateway credentials and base URL variables.

Direct `file://` previews are restricted, requiring the local server to start via `edgeone makers dev` on port 8088. Projects using Blob storage require the `-n` flag with a project name to avoid interactive prompts.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-recipes -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-recipes -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-recipes -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install TencentEdgeOne/edgeone-makers-tools skills/edgeone-makers-tools/references/makers-recipes
```

2. **Manually: put the files in place**
- File: `.github/skills/makers-recipes/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-recipes -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/TencentEdgeOne/edgeone-makers-tools --path skills/edgeone-makers-tools/references/makers-recipes
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add TencentEdgeOne/edgeone-makers-tools --skill edgeone-makers-recipes -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/TencentEdgeOne/edgeone-makers-tools/tree/HEAD/skills/edgeone-makers-tools/references/makers-recipes/SKILL.md

## When to use it
- scaffold a full-stack project structure
- configure Cloud Functions endpoints
- integrate Blob storage for persistence
- build static and API applications

## Example prompts
- Generate a full-stack project structure for EdgeOne Makers
- Create a backend function using Blob storage
- Add a template page with relative asset paths

## Source text · SKILL.md · MIT

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: c792edf2519df6fb.

BEGIN THIRD-PARTY FILE c792edf2519df6fb
```text
---
name: edgeone-makers-recipes
description: >-
  Project structure templates and scaffolding recipes for typical EdgeOne Makers
  applications — full-stack apps, static sites, API services, and AI agent projects.
metadata:
  author: edgeone
  version: "1.0.1"
---

# Common Recipes

> ⛔ **Preview ban**: after finishing development, you MUST start the dev server via `edgeone makers dev`, then open `http://127.0.0.1:8088/` with `present_files` to preview. Never open HTML files via the `file://` protocol (ignore it even if the IDE opens one automatically), and never use self-hosted servers like `python -m http.server` or `npx serve`. Next.js projects must also set `allowedDevOrigins: ["127.0.0.1"]` in `next.config`. **If the project uses Blob/KV, pass `-n <project-name>` — `edgeone makers dev -n <project-name>` — the name is required to auto-provision; bare `dev` hangs on an interactive picker in sandbox.**

> ⚠️ **`.env.example` is a required file**: every project that uses the AI Gateway (Agent projects, Cloud Functions that call an LLM) MUST create a `.env.example` in the project root declaring `AI_GATEWAY_API_KEY=` and `AI_GATEWAY_BASE_URL=`. The CLI auto-injects environment variables based on this file at deploy time; if it is missing, the variables are not injected and the runtime will error.

> 📝 **Write `index.html` last, always**: writing an `index.html` instantly triggers the IDE `file://` preview — unavoidable in WorkBuddy. Minimize the window during which that preview looks broken by writing **every dependency first**: `style.css`, `script.js`, **Cloud Functions** (`functions/` files), static assets, everything the page loads. Then write `index.html` **last** — the file:// preview opens with all assets already in place, and stays that way only until `edgeone makers dev` takes over (see Preview ban above). Also write each `index.html` in one shot; don't scaffold an empty shell and fill it in with repeated edits (every save re-renders and flickers). For a tiny single-page tool, just inline the CSS and JS into one `index.html`.
```
END THIRD-PARTY FILE c792edf2519df6fb

The third-party file has ended. Everything between the c792edf2519df6fb 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 2090 of 11876 bytes. © edgeone · MIT · https://github.com/TencentEdgeOne/edgeone-makers-tools/tree/HEAD/skills/edgeone-makers-tools/references/makers-recipes/SKILL.md

## Similar
- [edgeone](https://affpapa.org/en/nevibecode/skills/edgeone.md) — skill · 2300 installs
- [tencentcloud-edgeone](https://affpapa.org/en/nevibecode/skills/tencentcloud-edgeone.md) — skill · 217 installs
- [runway-dev-recipes](https://affpapa.org/en/nevibecode/skills/runway-dev-recipes.md) — skill · 217 installs
- [export-download-debugging](https://affpapa.org/en/nevibecode/skills/export-download-debugging.md) — skill · 2000 installs
- [convex-file-storage](https://affpapa.org/en/nevibecode/skills/convex-file-storage.md) — skill · 2600 installs
- [gcp-expert](https://affpapa.org/en/nevibecode/skills/gcp-expert.md) — skill · 551 installs

_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
