Skip to content
ACREACRE docs

Design your island with your agent

Every island is laid out and painted from one JSON file, the island manifest. Your agent can write it for you: it reads your README and site, finds your logo, and picks a shape, biome, colours, a landmark and what grows, so your island looks like your project and nobody else’s.

ACRE renders the manifest itself, deterministically: no image generation. The same manifest always gives the same island.

Set it up

Section titled “Set it up”

  1. In ACRE, open Island settings → Chats and connect your client. That gives it the island’s MCP tools, including the manifest tools.

  2. Install the acre-island-designer skill. In Claude Code:

    Terminal window
    mkdir -p ~/.claude/skills && curl -fsSL https://useacre.dev/skills/acre-island-designer.zip -o /tmp/acre-island-designer.zip && unzip -o /tmp/acre-island-designer.zip -d ~/.claude/skills

    Other clients can read it raw at https://useacre.dev/skills/acre-island-designer/SKILL.md.

  3. Ask: “Design my ACRE island from this repo.”

The agent then:

  1. reads the island (island_manifest_get) and your project;
  2. drafts a manifest from public metadata (island_manifest_suggest: your GitHub language and topics, your site’s theme colour, icon and the logo’s colours);
  3. edits it to fit the brand;
  4. checks it (island_manifest_validate), which names every problem by its JSON path;
  5. applies it (island_manifest_apply, hosts only) and sends you the link.

It can also commit the file to your repo at .well-known/acre-island.json, so the island can be re-applied whenever your brand changes.

Without an agent

Section titled “Without an agent”
  • Island settings → Theme is a friendly editor over the same JSON: pickers for the shape, size, biome, landmark, vegetation, decor, streets and colours, a logo drop, Suggest from my repo/site, and Edit the JSON, Upload manifest and Export manifest.
  • A new project island gets a theme derived from its repository straight away, so no two islands start out looking the same. Islands that were still on the default look get one too, once. Any theme you or your agent apply replaces it, and it never replaces one you set.
  • A self-hosted island puts the theme block in its signed manifest (Manifest reference).

Tools

Section titled “Tools”
Tool Who What
island_manifest_get members The island’s manifest now
island_manifest_suggest hosts A draft from a repo and/or a site
island_manifest_validate members Every problem with its path, or the manifest as it would be applied
island_manifest_apply hosts Lay out and paint the island from it

See the full island manifest reference.