From 7d2a7e8a441603faf5c47cd3392a0df588194cb2 Mon Sep 17 00:00:00 2001 From: daymade Date: Sun, 26 Oct 2025 08:40:01 +0800 Subject: [PATCH] Add versioning principle to skill-creator: SKILL.md should not contain versions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Critical guideline added: - Skills should NOT have version sections in SKILL.md - Version numbers belong in marketplace.json only (plugins[].version) - SKILL.md should be timeless content focused on functionality - Marketplace infrastructure manages versioning, not individual skills Rationale: - Discovered during ppt-creator development where version history was incorrectly added - Verified against Anthropic's official skills repository (no version sections found) - Aligns with marketplace architecture where versions are tracked centrally Location: Added to "Versioning" subsection under "Privacy and Path References" 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- skill-creator/SKILL.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/skill-creator/SKILL.md b/skill-creator/SKILL.md index 1e260dc..c153f1e 100644 --- a/skill-creator/SKILL.md +++ b/skill-creator/SKILL.md @@ -85,6 +85,16 @@ Files not intended to be loaded into context, but rather used within the output - **Allowed**: Standard placeholders (`~/workspace/project`, `username`, `your-company`) - **Best practice**: Use generic examples and placeholders; all paths should reference bundled skill files or use standard environment-agnostic patterns +##### Versioning + +**CRITICAL**: Skills should NOT contain version history or version numbers in SKILL.md: + +- **Forbidden**: Version sections (`## Version`, `## Changelog`, `## Release History`) in SKILL.md +- **Forbidden**: Version numbers in SKILL.md body content +- **Correct location**: Skill versions are tracked in marketplace.json under `plugins[].version` +- **Rationale**: Marketplace infrastructure manages versioning; SKILL.md should be timeless content focused on functionality +- **Example**: Instead of documenting v1.0.0 → v1.1.0 changes in SKILL.md, update the version in marketplace.json only + ### Progressive Disclosure Design Principle Skills use a three-level loading system to manage context efficiently: