spree-checkout

Manage Spree checkout state transitions and payment sessions.

4|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/spree/agent-skills --skill spree-checkout
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spree-checkout
Source: https://github.com/spree/agent-skills/tree/main/skills/spree-checkout
Command: npx skills add https://github.com/spree/agent-skills --skill spree-checkout

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Streamlines the checkout process in Spree, handling cart pipeline, order state machine, address handling, and customizing checkout steps.

Core Features & Use Cases

  • Checkout Flow Management: Manages cart to completed order transitions, including address, delivery, payment, confirmation, and completion steps.
  • Order State Machine: Provides the order state machine for checkout progress tracking.
  • Customization Hooks: Offers customization options for checkout steps and payment sessions.
  • Use Case: For example, if you need to skip the address step for digital-only orders or customize the payment flow, this Skill can help you achieve that.

Quick Start

Use the spree-checkout skill to process a checkout and ensure the order moves smoothly through the checkout states.

Frequently Asked Questions about spree-checkout

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

FAQPage Schema
How do I customize the Spree Commerce checkout flow to skip steps?

You can customize the Spree Commerce checkout flow using built-in hooks to skip specific steps like the address step for digital-only orders, modifying the order state machine to alter cart to order completion transitions.

How does the Spree order state machine handle checkout progress?

The Spree order state machine tracks checkout progress by managing transitions through address, delivery, payment, confirmation, and completion states, ensuring the cart moves smoothly to a completed order.

Can I modify payment session management during Spree checkout?

Yes, you can modify payment session management during Spree checkout using the provided customization hooks, allowing you to tailor the payment flow to fit specific e-commerce workflow requirements.

What is the best way to automate order processing in Spree?

Automating order processing in Spree is best handled by managing the checkout pipeline and order state transitions, ensuring cart to order completion automation including address handling and state tracking.

Does this approach support customizing checkout steps for digital-only orders?

Yes, the approach supports customizing checkout steps for digital-only orders, allowing you to skip unnecessary steps like address handling and streamline the cart to order completion pipeline.

Why are my Spree order state transitions failing during checkout?

Spree order state transitions may fail during checkout if the cart pipeline encounters unmet step prerequisites, requiring you to verify state machine rules and ensure address and payment sessions are correctly configured.