OpeItcLoc03/claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(wiki): skill-versioning — Rule 3 of project-discipline extends scope to all skills

Browse Source
This commit is contained in:
vitya
2026-05-01 11:34:15 +03:00
parent d0a450ce40
commit b72fc72577
1 changed files with 5 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
.wiki/concepts/skill-versioning.md
View File

@@ -1,7 +1,7 @@
--- ---
title: Skill versioning + bootstrap manifest title: Skill versioning + bootstrap manifest
type: concept type: concept
updated: 2026-04-28 updated: 2026-05-01
--- ---
# Skill versioning + bootstrap manifest # Skill versioning + bootstrap manifest
@@ -33,9 +33,11 @@ Bumped manually when `SKILL.md` is edited. No CI gate — discipline-based.
## What skills are versioned ## What skills are versioned
Currently only the **infrastructure** skills (the ones bootstrap touches and that govern project layout). Communication-mode skills (`caveman`, family) and discovery skills (`find-skills`, `active-platform`) aren't versioned — their content is "good copy-paste" and a snapshot mismatch isn't a layout problem. **Originally** only the **infrastructure** skills (the ones bootstrap touches and that govern project layout). Communication-mode skills (`caveman`, family) and discovery skills (`find-skills`, `active-platform`) were left unversioned — their content was "good copy-paste" and a snapshot mismatch wasn't a layout problem.
If we ever start packaging or marketplace-publishing the rest, we'll version them too. **As of `project-discipline` v0.1.0** (Rule 3), the requirement extends to **all** skills in this repo, regardless of category. Communication-mode and discovery skills also need `version:` in frontmatter; the migration is a separate one-time task tracked in `.tasks/`. Rationale: discipline-by-default is simpler than maintaining a list of "exempt" skills, and it costs nothing — `version: 0.1.0` is added on the next edit per the Rule 3 first-edit-unversioned clause.
If we ever start packaging or marketplace-publishing skills outside this repo, the same rule still applies.
## The manifest ## The manifest