Clubhouse-Workshop: Skill for Claude Code

Create Version Snapshot

You are creating a new SDK version snapshot. This involves parsing the Clubhouse app's source types, diffing against the previous version, and generating a complete new SDK version directory.

Step 1: Determine the target version

If a version number was provided via $ARGUMENTS, validate it. Otherwise, ask the user.

1. Read sdk/versions.json to find the current latest version
2. Validate the target version is greater than the current latest (use semver-style comparison on the version strings, e.g. "0.6" > "0.5")
3. If invalid, explain and ask again

Step 2: Locate the Clubhouse source

Ask the user for the path to the Clubhouse application source code, or reuse a previously provided path. The source of truth is:

<source-path>/src/shared/plugin-types.ts

Verify this file exists before proceeding. If it doesn't, ask for correction.

Step 3: Parse and diff

1. Read the source plugin-types.ts from the Clubhouse app
2. Read the previous version's sdk/v{prev}/plugin-types/index.d.ts
3. Compare the two and identify:
   • Added: New types, interfaces, methods, or properties
   • Changed: Modified signatures, added optional fields, changed types
   • Removed: Deleted types, interfaces, methods, or properties
4. Present a summary to the user in a clear table format:

API Changes: v{prev} → v{new}

Added:
  - api.foo.newMethod(args): ReturnType
  - NewInterface

Changed:
  - api.bar.existingMethod — added optional `options` parameter
  - ExistingType — field `x` changed from string to number

Removed:
  - api.baz.deprecatedMethod
  - OldInterface

1. Ask for confirmation before generating files

Step 4: Generate the new SDK version

On confirmation:

sdk/v{new}/plugin-types/

1. index.d.ts — The new type definitions, derived from the Clubhouse source. Add a header comment:

   /**
    * Clubhouse Plugin API — v{new}
    *
    * Type definitions for the Clubhouse plugin SDK.
    * Generated from the Clubhouse application source.
    *
    * @version {new}
    * @see https://github.com/Agent-Clubhouse/Clubhouse-Workshop
    */