agentleFS
acquiaacquia/acquia-skills/skills/acli/meo-sites/SKILL.md

meo-sites

Skill10 starsChanged 38 days agoMITView on GitHub

Use when listing, creating, updating, duplicating, recovering, or deleting MEO sites. Sites are the logical Drupal site definitions in a MEO multi-site subscription.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 0 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Note: All commands below use acli api:v3:* (V3 API).

    line 26
  2. Very specific:

    Only label and description can be updated after creation.

    line 87

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

MEO Site Management

Platform: This skill applies to MEO (Multi-site Enterprise Operations) subscriptions only. For ACE (Acquia Cloud Enterprise), see Application Management.

Use when:

  • Listing, inspecting, creating, or updating sites
  • Duplicating an existing site to create a new one
  • Scheduling a site for deletion or recovering it
  • Finding which sites belong to a codebase or subscription

Note: All commands below use acli api:v3:* (V3 API). Run acli list api:v3:sites to see all current site commands.


List Sites

# All sites you have access to
acli api:v3:sites:list

# Sites for a specific subscription
acli api:v3:subscriptions:list-sites <subscriptionId>

# Sites associated with a specific codebase
acli api:v3:codebases:list-sites <codebaseId>

# Sites in a specific environment
acli api:v3:environments:list-sites <environmentId>

Supports pagination: --offset=<n> and --limit=<n>.


Get Site Details

acli api:v3:sites:find <siteId>

Returns site id, name, label, codebase_id, status, and timestamps.


Create a Site

acli api:v3:sites:create <name> <label> <codebase_id>
ArgumentRequiredDescription
nameYesMachine name — lowercase letters and hyphens only, starts with a letter
labelYesHuman-readable display name
codebase_idYesUUID of the codebase this site will use
# Example
acli api:v3:sites:create my-new-site "My New Site" d3b07384-d9a0-4568-b1c0-e1e23f123456

Optional flags: --description="...", --site_id=<uuid> (supply your own UUID).


Update a Site

acli api:v3:sites:update <siteId> --label="New Label" --description="Updated description"

Only label and description can be updated after creation.


Duplicate a Site

Creates a new site by copying an existing one into one or more environments.

acli api:v3:sites:duplicate <sourceSiteId> <site_name> <site_label> <environment_mapping>
ArgumentRequiredDescription
site_nameYesMachine name for the new site
site_labelYesDisplay label for the new site
environment_mappingYesJSON array mapping source to destination environments
# Example — duplicate into the same environment
acli api:v3:sites:duplicate abc-site-uuid new-site "New Site" \
  '[{"source_environment_id":"env-uuid","destination_environment_id":"env-uuid"}]'

Optional: --hook_argument="..." passes a custom argument to duplication hooks.


Schedule a Site for Deletion

Caution: Schedules the site and all its site instances for deletion. Use acli api:v3:sites:recover within the grace period to cancel.

acli api:v3:sites:schedule-delete <siteId>

Recover a Site Scheduled for Deletion

acli api:v3:sites:recover <siteId>

Cancels a pending scheduled deletion. Must be run before the grace period expires.


Delete a Site

Destructive operation — explicit approval required. Permanently deletes the site and all associated site instances. This cannot be undone. Confirm with the user before executing.

acli api:v3:sites:delete <siteId>

Typical Workflows

Provision a new site

# 1. Find the codebase UUID
acli api:v3:subscriptions:list-codebases <subscriptionId>

# 2. Create the site
acli api:v3:sites:create my-site "My Site" <codebaseId>

# 3. Associate it with an environment (creates a site instance)
acli api:v3:environments:create-site-instance <environmentId> <siteId>

Clone a site for a new tenant

acli api:v3:sites:duplicate <originalSiteId> \
  tenant-new "Tenant New" \
  '[{"source_environment_id":"<envId>","destination_environment_id":"<envId>"}]'

Discover More Commands

acli list api:v3:sites
acli list api:v3:subscriptions
acli api:v3:sites:create --help

Related Topics

  • MEO Overview — ACE vs MEO, data model, authentication
  • MEO Codebases — Manage the git repository backing your sites
  • MEO Site Instances — Manage a site within a specific environment
  • MEO Environments — Environment-level operations

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.