Skip to content
Source
Sign inSign up
TanStack/ai

ai-skills: generateCatalog and staticSkills drop frontmatter metadata #2199

Send to my agent
Openaayushbtw(GitHub profile, opens in a new tab) opened this issue 0 comments

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.

  1. tanstack-source added labelsbug

  2. github-actions[bot](GitHub profile, opens in a new tab) added labelswaiting-on: maintainer

Sign in to join this conversation.