spacelift:preview

Generate a Spacelift preview plan for your Terraform module locally.

1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/fabn/claude-plugins --skill spacelift-preview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spacelift:preview
Source: https://github.com/fabn/claude-plugins/tree/main/plugins/spacelift/skills/preview
Command: npx skills add https://github.com/fabn/claude-plugins --skill spacelift-preview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Running Terraform changes against Spacelift requires uploading code and waiting for a plan, which can be slow and error‑prone. This Skill automates the local preview process, letting you see the impact of changes before pushing them.

Core Features & Use Cases

  • Detects whether Spacelift MCP tools are available and falls back to the spacectl CLI.
  • Identifies the appropriate stack automatically or prompts you to select one.
  • Executes a local preview, streams results, and formats a clear summary of added, changed, or destroyed resources.
  • Handles common errors such as missing tools, stack not found, timeouts, upload failures, and authentication issues.

Quick Start

Ask the assistant to run a Spacelift preview for the current Terraform module.

Frequently Asked Questions about spacelift:preview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preview Terraform changes locally before committing code to Spacelift?

To preview Terraform changes locally, this Skill runs a Spacelift preview against your current module to generate a plan before you push code. It automatically detects available Spacelift MCP tools or falls back to the spacectl CLI to execute the plan.

What's the best way to run a Spacelift local preview for a specific Terraform stack?

The best way to run a local preview is to let the Skill identify the appropriate Spacelift stack automatically or prompt you to select one. It then streams the preview results and formats a clear summary of added, changed, or destroyed resources.

Do I need the spacectl CLI to use Spacelift MCP tools for local Terraform previews?

You do not strictly need the spacectl CLI to run local Terraform previews if Spacelift MCP tools are available. The Skill detects MCP tools first and only falls back to the spacectl CLI if they are missing, requiring appropriate environment variables in both cases.

Can I test Terraform module changes against Spacelift without uploading code first?

Yes, you can test Terraform module changes without uploading code by running a local Spacelift preview. This bypasses the slow upload-and-wait process, letting you see the impact of changes immediately before committing them to a repository.

Why does my local Spacelift preview fail with authentication or stack not found errors?

Local Spacelift previews fail when authentication environment variables are missing, the specified stack is not found, or required tools are absent. The Skill handles these common errors and provides feedback, but you must ensure proper credentials and valid stack identifiers.

Does a local Spacelift preview support targeting specific resources in a Terraform plan?

Yes, a local Spacelift preview supports optional target resources during the Terraform plan generation. You can specify targets to narrow the scope of the preview and focus the plan output on specific infrastructure changes within your stack.