anthropics / anthropics/knowledge-work-plugins

Add stability lifecycle frontmatter to skills (experimental/stable/deprecated)

Open
#253 5 comments 2 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
24k
Forks
2.9k
Avg merge
1d 16h
Merged PRs (30d)
149

Description

## Problem
Skills in this plugin have no stability indicator. An AI agent consuming skills cannot distinguish a well-tested default skill from a new/beta one, causing it to treat experimental workflows as production-ready. This leads to wasted tool calls on deprecated MCP servers or experimental features whose APIs change without notice.

## Proposed solution
Add a `stability:` frontmatter field to the SKILL.md schema with three values:
- `experimental` — actively developed, may change without notice
- `stable` — tested, production-ready, backwards-compatible
- `deprecated` — maintained for compatibility but no longer actively developed

Skill authors set `stability:` in frontmatter when submitting. The plugin's README or skill discovery surface can document the field so agents can filter or warn accordingly.

## Use case
An AI agent scanning a large plugin pool for production-grade workflows can filter on `stability: stable` and warn before invoking `experimental` skills or skip `deprecated` ones entirely. This prevents wasted tool calls and incorrect routing assumptions.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.