Skills

Skills are user-authored instruction bundles that shape how the assistant works without granting new data, model, or tool access by themselves.

Implemented

Users can create, publish, archive, and select one active skill in chat.
Published skill versions are immutable runtime artifacts.
Runtime skill bundles are loaded through Mastra workspace skill tooling.
Mutable drafts do not affect assistant execution until a new version is published and selected.

Current Limits

Arbitrary multi-skill stacking is out of V1 scope.
Cross-user skill sharing is deferred.
User-defined tool grants are not part of the current skills model.
Research workspace skill reuse is planned with immutable version snapshots.

Read Next

Canonical Sources

docs/features/skills/spec.md
docs/features/skills/decisions/ADR-001-published-mastra-skill-runtime.md
docs/features/skills/stories/
docs/features/skills/tests/
apps/api/src/mastra/skills
apps/web/app/pages/skills