Skip to content

docs(ecosystem): flag SKILL.md/plugin.json version sync is a required CI gate#41

Merged
CybotTM merged 1 commit into
mainfrom
docs/skill-repo-version-sync-enforcement
Jun 24, 2026
Merged

docs(ecosystem): flag SKILL.md/plugin.json version sync is a required CI gate#41
CybotTM merged 1 commit into
mainfrom
docs/skill-repo-version-sync-enforcement

Conversation

@CybotTM

@CybotTM CybotTM commented Jun 24, 2026

Copy link
Copy Markdown
Member

What

Enhances the Skill Repositories ecosystem entry in references/ecosystem-detection.md.

The section already listed both .claude-plugin/plugin.json and skills/*/SKILL.md as version files, but nothing flagged two things that cause real release friction:

  1. The match is a required CI gate. GitHub skill repos run a required Skill Validation check with a step "Validate SKILL.md metadata.version matches plugin.json". A bump PR that touches only plugin.json is BLOCKED until every SKILL.md is bumped too.
  2. A repo may ship multiple skills. skills/*/SKILL.md is a glob (e.g. jira-communication + jira-syntax) — every SKILL.md's metadata.version must be bumped.
  3. Noted that the GitLab ci-components/claude-code-skill pipeline only validates plugin.json against the tag (not SKILL.md).

Why

Discovered while cutting 13 skill releases: bumping only plugin.json failed Skill Validation on all of them, requiring an amend + force-push of every SKILL.md.

Docs-only; no version change.

… CI gate

The Skill Repositories section already lists both version files, but nothing
warned that the match is enforced by the required 'Skill Validation' check
(step 'Validate SKILL.md metadata.version matches plugin.json'), nor that a
repo may ship multiple skills whose SKILL.md must ALL be bumped. Bumping only
plugin.json silently BLOCKS the PR. Note the GitLab component only checks
plugin.json against the tag.

Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
Copilot AI review requested due to automatic review settings June 24, 2026 16:24
@gemini-code-assist

Copy link
Copy Markdown

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@github-actions

Copy link
Copy Markdown

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@github-actions github-actions Bot added documentation Improvements or additions to documentation skill labels Jun 24, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@CybotTM CybotTM merged commit 64c6787 into main Jun 24, 2026
21 of 22 checks passed
@CybotTM CybotTM deleted the docs/skill-repo-version-sync-enforcement branch June 24, 2026 20:50
@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation skill

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants