Distribution model

The repository keeps each skill in skills/<name>/. Root manifests let the Skills CLI, Codex, and Claude Code install those directories without maintaining separate copies of the instructions.

Canonical sources

skills/
├── phone-size/
├── sams-tree/
├── sams-status/
├── sams-env/
├── andrej-explain/
├── migrate-cgpt/
├── sales-research/
├── sams-gen-writing/
├── sams-skill-creator/
├── sam-ux-audit/
├── zach-prompting/
└── htma-measure/

Each folder contains discovery metadata, instructions, supporting resources, and UI metadata. Installers use these directories.

Open Skills CLI

The CLI clones or reads the repository, discovers every skills/*/SKILL.md, and lets the user select one skill. It copies or links only the selected directory into the target agent’s skill location and records the source, skill path, and content hash in a lock file.

This is the narrowest installation route when only one skill is needed.

Codex marketplace bundle

Codex first clones the repository as a marketplace snapshot. The marketplace catalog retains the stable install ID htma-measure, while .codex-plugin/plugin.json points at ./skills/ and presents the collection as Sam’s Skills.

Installing that plugin exposes every current skill. The stable install ID avoids breaking existing marketplace installations; it does not control a skill’s name or Claude command prefix.

Claude Code marketplace bundle

Claude clones the repository as a marketplace. The plugin entry uses "source": "./", so Claude copies the plugin from the same checkout instead of cloning the public repository a second time. Claude automatically discovers the skill directories under the plugin root’s skills/ folder.

The marketplace install ID remains htma-measure, but the plugin manifest sets the collection namespace to sam. Bundled Claude Code commands therefore use /sam:<skill>, including /sam:zach-prompting and /sam:htma-measure. A standalone Skills CLI installation uses the unbundled skill name.

Manual consumers

Any compatible agent can load a chosen SKILL.md directly and resolve its relative references/, assets/, and agents/ paths.

Versioning

• Root, Codex, and Claude manifests carry the same collection version.
• Root plugin.json declares the portable Agent Plugins schema; the Codex overlay supplies compatible presentation metadata.
• Bump all three versions for package changes so cached installations can update.
• The Open Skills CLI tracks each selected skill folder’s content hash independently.
• Documentation deploys do not duplicate or rewrite canonical skill content.