Stats

Actions

Tags

Help us improve

Share bugs, ideas, or general feedback.

spacelift:status | spacelift

Skill

spacelift:status

This skill should be used when the user wants to list Spacelift stacks, check stack status, show stack details, view dependencies, or get an overview of their Spacelift infrastructure. Activates on: "spacelift", "spacelift status", "list stacks", "spacelift stacks", "check spacelift", "show stack", "stack details", "spacelift dependencies", "spacelift resources", "spacelift overview", "stato spacelift", "controlla spacelift", "lista stack", "dipendenze spacelift".

$

npx claudepluginhub fabn/claude-plugins --plugin spacelift

Invocation

How this skill is triggered — by the user, by Claude, or both

Slash command

/spacelift:status

User invocable

Model invocable

Inline context

Default effort

Context Preview

The summary Claude sees in its skill listing — used to decide when to auto-load this skill

List and inspect Spacelift stacks, check their status, view dependencies, and browse managed resources.

Supporting Files

reference/spacectl-tools.md

SKILL.md

78 lines · ~766 tokens

Similar Skills

receiving-code-review

221.0k

Guides technical evaluation of code review feedback: read fully, restate for understanding, verify against codebase, respond with reasoning or pushback before implementing.

Stats

LanguageShell

Parent stars0

MaintenanceGood

Last CommitApr 4, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Spacelift Status Skill

List and inspect Spacelift stacks, check their status, view dependencies, and browse managed resources.

Reference files: Consult reference/spacectl-tools.md for the full MCP tool catalog, CLI equivalents, and GraphQL queries.

Tools Used

Spacelift MCP (spacelift.spacectl-mcp): list_stacks, list_resources, list_contexts, list_spaces
Bash: CLI fallback via spacectl, stack dependencies (CLI only)
ToolSearch: Discover available Spacelift MCP tools

Workflow

Step 1: Detect Tools

Use ToolSearch with query spacelift to check if MCP tools are available. See reference/spacectl-tools.md § Tool Detection.

Step 2: Identify Request

Determine what the user wants:

User intent	Action
List all stacks	`list_stacks` (MCP) or `spacectl stack list -o json` (CLI)
Search for a stack	`list_stacks` with `search` param
Stack details	`list_stacks` with `search` to find it, then present details
Stack dependencies	`spacectl stack dependencies on/off --id <slug>` (CLI only)
Resources for a stack	`list_resources` with `stack_id`
All resources	`list_resources` without filters
Contexts / Spaces	`list_contexts`, `list_spaces`

Step 3: Present Results

Format output as a summary table:

| Stack | Status | Branch | Repository |
|-------|--------|--------|------------|
| my-stack | FINISHED | main | org/repo |

For a single stack, show full details: name, slug, branch, repository, project root, labels, current state, and latest tracked run status.

Step 4: Check Status After Push (if relevant)

If the user is on a feature branch and wants to know if Spacelift picked up their changes:

Get current branch: git branch --show-current
Determine the relevant stack (from project root or ask the user)
Use list_stack_proposed_runs to find preview runs for the branch
Report the latest run state and delta

Error Handling

Situation	Action
MCP tools not available	Fall back to CLI. See `reference/spacectl-tools.md` § CLI Equivalents
Authentication failure	Check `SPACELIFT_API_GITHUB_TOKEN` and `SPACELIFT_API_KEY_ENDPOINT` env vars
Stack not found	Use `list_stacks` with search to find the correct slug
No stacks returned	Verify authentication and permissions on the Spacelift account

Reference Files

reference/spacectl-tools.md — Full MCP tool catalog, CLI equivalents, GraphQL queries