Back to Skills

validate-and-ship

verified

Validate plugins, clean repository, and ship changes in one automated workflow

View on GitHub

Marketplace

troys-plugins

davistroy/claude-marketplace

Plugin

personal-plugin

productivity

Repository

davistroy/claude-marketplace
1stars

plugins/personal-plugin/skills/validate-and-ship/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/davistroy/claude-marketplace/blob/main/plugins/personal-plugin/skills/validate-and-ship/SKILL.md -a claude-code --skill validate-and-ship

Installation paths:

Claude
.claude/skills/validate-and-ship/
Powered by add-skill CLI

Instructions

# Validate and Ship

Automated pre-flight checks and shipping workflow. Executes validation, cleanup, and git workflow in sequence, stopping only when user intervention is required.

## Input Validation

**Optional Arguments:**
- `--skip-validate` - Skip plugin validation phase
- `--skip-cleanup` - Skip repository cleanup phase
- `--dry-run` - Preview all phases without executing changes
- `<branch-name>` - Custom branch name for shipping (passed to ship phase)

**Dry-Run Mode:**
When `--dry-run` is specified:
- Run validation (read-only, always safe)
- Preview cleanup changes without executing
- Preview ship operations without executing
- Prefix all output with `[DRY-RUN]`

## Workflow Overview

```
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Phase 1:       │     │  Phase 2:       │     │  Phase 3:       │
│  Validate       │────▶│  Clean Repo     │────▶│  Ship           │
│  Plugins        │     │                 │     │                 │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │                       │
        ▼                       ▼                       ▼
   STOP if errors          Continue with           Full ship
   CONTINUE if warnings    artifact cleanup        workflow
```

## Execution

Execute each phase in sequence. Only stop for blocking issues that require user intervention.

---

## Phase 1: Plugin Validation

Run `/validate-plugin --all` to check all plugins in the repository.

### 1.1 Execute Validation

Perform the full validation as defined in `/validate-plugin`:
- Structure validation
- Skill structure validation (nested directories, `name` field)
- Frontmatter validation
- Marketplace schema validation
- Version synchronization
- Content validation
- Namespace collision detection
- Pattern compliance

### 1.2 Evaluate Results

**Blocking (STOP):**
- Any validation errors (missing required fields, invalid structure, version mismatch)
- Display the error summ

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
7366 chars