Skip to content

[Doc] Point the Skills specification links at its beta directory - #644

Merged
koic merged 1 commit into
modelcontextprotocol:mainfrom
koic:point_the_skills_specification_links_at_its_beta_directory
Nov 1, 2026
Merged

koic merged 1 commit into
modelcontextprotocol:mainfrom
koic:point_the_skills_specification_links_at_its_beta_directory

Conversation

@koic

@koic koic commented Nov 1, 2026

Copy link
Copy Markdown
Member

Motivation and Context

SEP-3392 (Extension Lifecycle) is Final and marks the stage of an extension by the directory that holds its specification. It classifies Skills as Beta, so ext-skills moved specification/stable/skills.mdx to specification/beta/skills.mdx on 2026-10-29 (modelcontextprotocol/ext-skills#161) with the text unchanged. GitHub does not redirect a moved path, so the link on the Skills docs page and the one in the MCP::Skill class comment answered 404.

Both now point at the beta path. The docs page also stops calling the text "stable", since that word now names a lifecycle stage the extension has not reached.

How Has This Been Tested?

The new URL answers HTTP 200 where the old one answers 404; the two files hold no other reference to the old path.

Breaking Changes

None.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Documentation
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have added or updated documentation as needed

## Motivation and Context

SEP-3392 (Extension Lifecycle) is Final and marks the stage of an extension by the directory that holds its specification.
It classifies Skills as Beta, so ext-skills moved `specification/stable/skills.mdx` to `specification/beta/skills.mdx`
on 2026-10-29 (modelcontextprotocol/ext-skills#161) with the text unchanged. GitHub does not redirect a moved path,
so the link on the Skills docs page and the one in the `MCP::Skill` class comment answered 404.

Both now point at the beta path. The docs page also stops calling the text "stable", since that word now names
a lifecycle stage the extension has not reached.

## How Has This Been Tested?

The new URL answers HTTP 200 where the old one answers 404; the two files hold no other reference to the old path.

## Breaking Changes

None.
@koic
koic merged commit 3b2c60b into modelcontextprotocol:main Nov 1, 2026
13 checks passed
@koic
koic deleted the point_the_skills_specification_links_at_its_beta_directory branch November 1, 2026 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant