How do I install the Codestudio skill?

Run npx skillmds@latest add acquia/codestudio-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Codestudio safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Codestudio?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Codestudio free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Proprietary.

Who published Codestudio?

acquia (@acquia) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Codestudio by acquia — Agent Skill

Name: Codestudio
Author: acquia

File contents

Code Studio with Acquia CLI

Use when:

Setting up a new Code Studio project for a Cloud application
Changing the PHP version used in Code Studio builds
Migrating an existing acquia-pipelines.yml to a .gitlab-ci.yml file

Note: This skill covers Code Studio setup only. To trigger builds, check job status, or stream logs, use pipelines-cli (pipelines-cli-pipeline-operations).

Code Studio is Acquia's GitLab-based CI/CD platform. It runs build pipelines, automated tests, and deployments for your Cloud Platform applications.

Set Up Code Studio (Wizard)

The wizard creates and configures a Code Studio project for your application:

acli codestudio:wizard

Alias: acli cs:wizard

The wizard will:

Authenticate with your Cloud Platform application
Connect to your GitLab instance
Create or configure a Code Studio project
Set up CI/CD variables

Non-interactive (provide all credentials upfront):

acli codestudio:wizard \
  --key="$ACQUIA_KEY" \
  --secret="$ACQUIA_SECRET" \
  --gitlab-token="$GITLAB_TOKEN" \
  --gitlab-project-id=12345 \
  --gitlab-host-name=code.acquia.com

Security: Never pass credential values directly in the command line — they appear in shell history and process listings. Always source them from environment variables or a secrets manager.

Options:

Option	Description
`--key`	Cloud Platform API key for Code Studio to use
`--secret`	Cloud Platform API secret for Code Studio to use
`--gitlab-token`	GitLab personal access token
`--gitlab-project-id`	Integer project ID of the GitLab project to configure
`--gitlab-host-name`	GitLab hostname (defaults to Acquia's instance)

Change PHP Version in Code Studio

Update the PHP version used in Code Studio build containers:

acli codestudio:php-version <version>

Example:

acli codestudio:php-version 8.2
acli codestudio:php-version 8.3

Typical Workflow: Onboard to Code Studio

# Step 1: Set up Code Studio project
acli codestudio:wizard

# Step 2: Set PHP version if needed
acli codestudio:php-version 8.2

Best Practices

Run the wizard first — It sets up all required CI/CD variables automatically.
Use environment variables for credentials in CI — Pass --key, --secret, and --gitlab-token via environment variables (e.g., --key="$ACQUIA_KEY"), never as literal values. Store secrets in your CI/CD platform's secret store.
Match PHP versions — Ensure codestudio:php-version matches the version in your composer.json platform requirements.

Troubleshooting

"GitLab project not found"

Verify the project ID and that your token has access:

# Re-run wizard interactively to select the right project
acli codestudio:wizard

Authentication errors

Ensure your Cloud API key/secret are valid:

acli auth:login
acli auth:me

Related Topics

Getting Started — Authentication setup
Environment Management — Deploy to environments
Pull & Push — Push build artifacts

---name: codestudio-2description: Use when setting up a new Code Studio (GitLab CI/CD) project, changing PHP version in Code Studio builds. NOT for checking pipeline job status — use pipelines-cli-pipeline-operations for that.license: Proprietary---# Code Studio with Acquia CLIUse when:- Setting up a new Code Studio project for a Cloud application- Changing the PHP version used in Code Studio builds- Migrating an existing `acquia-pipelines.yml` to a `.gitlab-ci.yml` file> **Note:** This skill covers Code Studio *setup* only. To trigger builds, check job status, or stream logs, use **pipelines-cli** (`pipelines-cli-pipeline-operations`).Code Studio is Acquia's GitLab-based CI/CD platform. It runs build pipelines, automated tests, and deployments for your Cloud Platform applications.---## Set Up Code Studio (Wizard)The wizard creates and configures a Code Studio project for your application:```bashacli codestudio:wizard```Alias: `acli cs:wizard`The wizard will:1. Authenticate with your Cloud Platform application2. Connect to your GitLab instance3. Create or configure a Code Studio project4. Set up CI/CD variables**Non-interactive (provide all credentials upfront):**```bashacli codestudio:wizard \ --key="$ACQUIA_KEY" \ --secret="$ACQUIA_SECRET" \ --gitlab-token="$GITLAB_TOKEN" \ --gitlab-project-id=12345 \ --gitlab-host-name=code.acquia.com```> **Security:** Never pass credential values directly in the command line — they appear in shell history and process listings. Always source them from environment variables or a secrets manager.Options:| Option | Description ||---|---|| `--key` | Cloud Platform API key for Code Studio to use || `--secret` | Cloud Platform API secret for Code Studio to use || `--gitlab-token` | GitLab personal access token || `--gitlab-project-id` | Integer project ID of the GitLab project to configure || `--gitlab-host-name` | GitLab hostname (defaults to Acquia's instance) |---## Change PHP Version in Code StudioUpdate the PHP version used in Code Studio build containers:```bashacli codestudio:php-version <version>```Example:```bashacli codestudio:php-version 8.2acli codestudio:php-version 8.3```## Typical Workflow: Onboard to Code Studio```bash# Step 1: Set up Code Studio projectacli codestudio:wizard# Step 2: Set PHP version if neededacli codestudio:php-version 8.2```---## Best Practices1. **Run the wizard first** — It sets up all required CI/CD variables automatically.2. **Use environment variables for credentials in CI** — Pass `--key`, `--secret`, and `--gitlab-token` via environment variables (e.g., `--key="$ACQUIA_KEY"`), never as literal values. Store secrets in your CI/CD platform's secret store.3. **Match PHP versions** — Ensure `codestudio:php-version` matches the version in your `composer.json` platform requirements.---## Troubleshooting### "GitLab project not found"Verify the project ID and that your token has access:```bash# Re-run wizard interactively to select the right projectacli codestudio:wizard```### Authentication errorsEnsure your Cloud API key/secret are valid:```bashacli auth:loginacli auth:me```---## Related Topics- **[Getting Started](../getting-started/SKILL.md)** — Authentication setup- **[Environment Management](../environment-management/SKILL.md)** — Deploy to environments- **[Pull & Push](../pull-push/SKILL.md)** — Push build artifacts

Frequently asked questions

Codestudio