create-version-snapshot

Crawl Clubhouse source, diff API changes, and package a new SDK version snapshot.

2|2|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/Agent-Clubhouse/Clubhouse-Workshop --skill create-version-snapshot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-version-snapshot
Source: https://github.com/Agent-Clubhouse/Clubhouse-Workshop/tree/main/.claude/skills/create-version-snapshot
Command: npx skills add https://github.com/Agent-Clubhouse/Clubhouse-Workshop --skill create-version-snapshot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of a new SDK version snapshot by crawling the Clubhouse app source, diffing it against the previous version, and packaging a self-contained SDK snapshot.

Core Features & Use Cases

  • End-to-end automation of generating a new sdk version directory, including diffing the API surface and assembling TypeScript definitions, changelog, and tests.
  • Ensures diffs are captured and versioned consistently to support stable SDK releases.
  • Useful when the Clubhouse API changes and a new SDK version is required for downstream plugins.

Quick Start

Provide the target version and path to the Clubhouse source to start the snapshot generation.

Frequently Asked Questions about create-version-snapshot

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

FAQPage Schema
How do I automate SDK version snapshot creation when the API changes?

Automating SDK version snapshot creation involves crawling the Clubhouse source, diffing it against the current latest version, and packaging a self-contained sdk/v{new} directory for deterministic upgrades and reproducible builds.

What is the best way to diff TypeScript API types against a previous SDK version?

Diffing TypeScript API types against a previous SDK version requires parsing the Clubhouse source, comparing the extracted types with the previous snapshot, and generating an updated index.d.ts file to capture API surface changes consistently.

How do I generate a changelog and testing scaffolds for a new SDK version?

Generating a changelog and testing scaffolds for a new SDK version is handled automatically during snapshot packaging, producing a self-contained directory that includes CHANGELOG.md, README, and the necessary testing scaffolds.

Do I need to provide a specific path to the Clubhouse source to start SDK snapshot generation?

Yes, you need to provide the target version number and the path to the Clubhouse source code to initiate the snapshot generation process and locate the API definitions for diffing.

When do I need to create a new SDK version snapshot?

You need to create a new SDK version snapshot when the Clubhouse API changes and a new SDK version is required for downstream plugins to ensure deterministic upgrades and reproducible builds.

What files are included in the packaged SDK version directory?

The packaged SDK version directory includes index.d.ts for TypeScript definitions, CHANGELOG.md for version history, a README, and testing scaffolds to support stable and reproducible SDK releases.