feat: add license metadata to skill frontmatter

convex/httpApiV1/skillsV1.ts

@@ -45,7 +45,7 @@ type ListSkillsResult = {
       version: string
       createdAt: number
       changelog: string
-      parsed?: { clawdis?: { os?: string[]; nix?: { plugin?: boolean; systems?: string[] } } }
+      parsed?: { clawdis?: { os?: string[]; nix?: { plugin?: boolean; systems?: string[] } }; license?: { spdx: string; uri?: string } }
     } | null
   }>
   nextCursor: string | null
@@ -213,6 +213,7 @@ export async function listSkillsV1Handler(ctx: ActionCtx, request: Request) {
           systems: item.latestVersion.parsed.clawdis.nix?.systems ?? null,
         }
       : null,
+    license: item.latestVersion?.parsed?.license ?? null,
   }))
 
   return json({ items, nextCursor: result.nextCursor ?? null }, 200, rate.headers)
@@ -309,6 +310,7 @@ export async function skillsGetRouterV1Handler(ctx: ActionCtx, request: Request)
               systems: result.latestVersion.parsed.clawdis.nix?.systems ?? null,
             }
           : null,
+        license: result.latestVersion?.parsed?.license ?? null,
         owner: result.owner
           ? {
               handle: result.owner.handle ?? null,
@@ -417,6 +419,7 @@ export async function skillsGetRouterV1Handler(ctx: ActionCtx, request: Request)
             contentType: file.contentType ?? null,
           })),
           security,
+          license: version.parsed?.license ?? null,
         },
       },
       200,

convex/lib/skillPublish.test.ts

@@ -102,4 +102,26 @@ description: Expert guidance for sushi-rolls.
     expect(signals.bodyWords).toBeGreaterThanOrEqual(45)
     expect(quality.decision).toBe('pass')
   })
+
+  describe('resolveLicense', () => {
+    it('uses explicit args.license when valid', () => {
+      const license = __test.resolveLicense({ spdx: 'Apache-2.0' }, { license: 'MIT' })
+      expect(license).toEqual(expect.objectContaining({ spdx: 'Apache-2.0' }))
+    })
+
+    it('falls back to frontmatter when args.license is null', () => {
+      const license = __test.resolveLicense(null, { license: 'MIT' })
+      expect(license).toEqual(expect.objectContaining({ spdx: 'MIT' }))
+    })
+
+    it('falls back to frontmatter when args.license is invalid', () => {
+      const license = __test.resolveLicense({ bad: 'data' }, { license: 'MIT' })
+      expect(license).toEqual(expect.objectContaining({ spdx: 'MIT' }))
+    })
+
+    it('returns undefined when both are invalid', () => {
+      const license = __test.resolveLicense({ bad: 'data' }, {})
+      expect(license).toBeUndefined()
+    })
+  })
 })

convex/lib/skillPublish.ts

@@ -25,6 +25,7 @@ import {
   isTextFile,
   parseClawdisMetadata,
   parseFrontmatter,
+  parseLicenseField,
   sanitizePath,
 } from './skills'
 import type { WebhookSkillPayload } from './webhooks'
@@ -46,6 +47,7 @@ export type PublishVersionArgs = {
   version: string
   changelog: string
   tags?: string[]
+  license?: unknown
   forkOf?: { slug: string; version?: string }
   source?: {
     kind: 'github'
@@ -130,6 +132,7 @@ export async function publishVersionForUser(
   const readmeText = await fetchText(ctx, readmeFile.storageId)
   const frontmatter = parseFrontmatter(readmeText)
   const clawdis = parseClawdisMetadata(frontmatter)
+  const license = resolveLicense(args.license, frontmatter)
   const owner = (await ctx.runQuery(internal.users.getByIdInternal, {
     userId,
   })) as Doc<'users'> | null
@@ -268,6 +271,7 @@ export async function publishVersionForUser(
       frontmatter,
       metadata,
       clawdis,
+      license,
     },
     summary,
     embedding,
@@ -356,11 +360,16 @@ function mergeSourceIntoMetadata(
   return Object.keys(base).length ? base : undefined
 }
 
+function resolveLicense(argsLicense: unknown, frontmatter: Record<string, unknown>) {
+  return (argsLicense != null ? parseLicenseField({ license: argsLicense }) : undefined) ?? parseLicenseField(frontmatter)
+}
+
 export const __test = {
   mergeSourceIntoMetadata,
   computeQualitySignals,
   evaluateQuality,
   toStructuralFingerprint,
+  resolveLicense,
 }
 
 export async function queueHighlightedWebhook(ctx: MutationCtx, skillId: Id<'skills'>) {