SkillMetadata has metadata?: Record<string, string> (the Agent Skills spec's metadata map), and parseFrontmatter reads it, but a static catalog loses it:
generateCatalog (@tanstack/ai-skills/node, also behind the Vite plugin's virtual:tanstack-skills) copies compatibility into each GeneratedSkill but not metadata.
staticSkills(catalog).list() maps each skill to name, description and compatibility only.
GeneratedSkill has no metadata field.
So a skill bundled from disk with
---
name: pdf
description: ...
metadata:
tags: files
---
lists with metadata undefined, while the same skill from fsSkills keeps it.
Expected: metadata carried through generateCatalog, GeneratedSkill and staticSkills().list(), as compatibility is. Seen on 1.0.1 and 1.0.2.
Fix we run as a patch: add ...meta.metadata && { metadata: meta.metadata } in generateCatalog, ...s.metadata && { metadata: s.metadata } in staticSkills().list(), and metadata?: Record<string, string> on GeneratedSkill. Happy to open a PR.