openspec-ship

Generate as-built OpenSpec documentation for shipped features.

6|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/damianpapadopoulos/auto-claude-skills --skill openspec-ship
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-ship
Source: https://github.com/damianpapadopoulos/auto-claude-skills/tree/main/skills/openspec-ship
Command: npx skills add https://github.com/damianpapadopoulos/auto-claude-skills --skill openspec-ship

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that OpenSpec documentation for shipped features is created, preserving the as-built artifacts and providing a historical record of the feature development.

Core Features & Use Cases

  • As-Built Documentation: Generates permanent "as-built" OpenSpec documentation from completed code.
  • Automatic Invocation: Automatically runs as part of the SHIP composition chain during the feature development lifecycle.
  • Skip Criteria: Defines specific criteria under which the Skill can be skipped without compromising the integrity of the development process.
  • CLI & Fallback: Uses OpenSpec CLI commands for the most reliable operations and provides fallbacks using Claude-native templates if the CLI is not available.

Quick Start

Use the openspec-ship skill during the SHIP phase after verification passes. It runs automatically if no special criteria for skipping are met.

Frequently Asked Questions about openspec-ship

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

FAQPage Schema
How do I generate as-built documentation for shipped features?

To generate as-built documentation for shipped features, use the openspec-ship Skill during the SHIP phase after verification passes. It automates OpenSpec documentation generation and archiving to preserve the completed code artifacts.

Does OpenSpec documentation generation require the OpenSpec CLI?

OpenSpec documentation generation prefers the OpenSpec CLI for reliable operations, but does not strictly require it. The Skill provides Claude-native template fallbacks to generate as-built documentation if the CLI is unavailable.

How does feature archiving work during the SHIP phase?

Feature archiving during the SHIP phase works by automatically invoking the documentation generator after code verification passes. It preserves as-built OpenSpec artifacts alongside Superpowers execution artifacts to maintain a historical development record.

When should I skip OpenSpec documentation generation for completed code?

You should skip OpenSpec documentation generation when specific predefined skip criteria are met during the SHIP phase. The Skill evaluates these conditions automatically to avoid compromising the integrity of the feature development process.

What is the best way to preserve as-built artifacts from feature development?

The best way to preserve as-built artifacts from feature development is to automate OpenSpec documentation generation during the SHIP phase. This ensures permanent historical records are created alongside Superpowers execution artifacts.

Why does my OpenSpec documentation fail to archive shipped features?

OpenSpec documentation fails to archive shipped features if the OpenSpec CLI is missing or unavailable, or if the SHIP phase verification has not successfully passed. It may also fail if required execution artifacts are incomplete.