@drawcall/market 0.1.32 → 0.1.34

package/dist/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO;IACP,gBAAgB;IAChB,SAAS;IACT,oBAAoB;IACpB,UAAU;IACV,cAAc;IACd,kBAAkB;IAClB,aAAa;IACb,UAAU;CACF,CAAA;AAGV,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;AAElD,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAE3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,EAAE;KACR,KAAK,CACJ,oDAAoD,EACpD,6CAA6C,CAC9C,CAAA;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CACJ,8BAA8B,EAC9B,0EAA0E,CAC3E;KACA,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;IAC5C,OAAO,EAAE,0EAA0E;CACpF,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;AAEjF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;AAEnF,yEAAyE;AACzE,8EAA8E;AAC9E,4BAA4B;AAC5B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;AAEnF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACrC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;CACxE,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE;IAChC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC9C,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,YAAY;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC5C,eAAe,EAAE,qBAAqB;IACtC,iBAAiB,EAAE,uBAAuB;IAC1C,iBAAiB,EAAE,uBAAuB;IAC1C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACtC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,YAAY;CACtB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACxC,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAA"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/skill.d.ts

@@ -1,2 +1,2 @@
-export declare const marketSkill = "---\nname: market\ndescription: Find, preview, install, generate, and publish Drawcall Market assets from a coding agent.\n---\n\n# Drawcall Market\n\nUse the `market` CLI. Keep commands short and read the summary lines.\n\n## Quick Start\n\n```sh\nmarket search \"wooden chair\" --type model --limit 3\nmarket install wooden-chair --cwd \"$PWD\"\nmarket preview wooden-chair --out /tmp/wooden-chair.png\n```\n\n## Workflow\n\n1. Search first unless the user already gave an exact asset name. `search` requires `--type`; use `model` unless the user names another supported type: `humanoid-model`, `texture`, `humanoid-animation`, `template`, `sound-effect`, `background-music`, or `environment`.\n2. Use `--limit 1` for lookup, `--limit 3` for choice. Search caps at 5. Add `--verbose` only when the one-line descriptions are not enough.\n3. `install` takes one or more exact asset names (optionally `name@range`); it does not search or generate. Find names with `search` first. No `--type` is needed \u2014 asset names are unique.\n4. `preview <name>` saves the preview image; no `--type` is needed. Not every type has previews (e.g. `humanoid-animation`, `template`, `sound-effect`, `background-music`); the CLI reports when one is unavailable.\n5. Use `--unapproved` only when the user asks for unapproved/private/admin assets. Do not install unapproved assets without explicit acceptance.\n6. `generate --type <type> \"<prompt>\"` creates a new asset; it requires login and a type that supports generation. No asset type currently supports generation.\n7. Upload only when publishing is requested: `market upload <name> <zip> \"<description>\" --type <type>`. Declare dependencies with repeatable flags: `--npm name@range`, `--asset name@range`, `--skill label=source`. A skill source is a `skills add` argument: a whole repo (`owner/repo` or a git URL), a single skill via the full URL form `https://github.com/owner/repo/tree/<branch>/<subpath>` (the `tree/<branch>/<subpath>` shorthand needs the full URL, not `owner/repo`), or a local path to a skill directory inside the zip. Example: `market upload my-scene scene.zip \"A scene\" --type model --npm three@^0.178.0 --skill web-design=https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines`.\n8. Installed `environment` assets contain `public/environment/<name>.hdr` for Three.js IBL lighting and `public/environment/<name>-background.webp` for the visible equirectangular background. Use `market preview` to fetch the preview image separately.\n\n## Output\n\nCommands print concise, line-oriented summaries:\n\n```text\nResults: 2/8 query=\"wooden chair\" type=model approval=approved\n- wooden-chair@1.0.0 | model | approved | Low-poly wooden chair\nInstalled:\n- wooden-chair@1.0.0 (asset)\n  files:\n    public/model\n    \u2514\u2500 wooden-chair.glb\n- three@^0.178.0 (npm)\n- web-design \u2190 https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines (skill)\nSaved preview for wooden-chair@1.0.0: /tmp/wooden-chair.png\n```\n\nAssets may also declare `skill` dependencies, installed for you via the `skills` CLI (`skills add`) during `install`. Sources are either a GitHub/git ref or a local path to a skill directory shipped inside the asset. This requires `npx` to be available.\n\nIf search returns no results, try one broader noun phrase. If a command returns `Error: Not logged in...`, ask before running `market login`.\n";
+export declare const marketSkill = "---\nname: market\ndescription: Find, preview, install, generate, and publish Drawcall Market assets from a coding agent.\n---\n\n# Drawcall Market\n\nUse the `market` CLI. Keep commands short and read the summary lines.\n\n## Quick Start\n\n```sh\nmarket search \"wooden chair\" --type model --limit 3\nmarket install wooden-chair --cwd \"$PWD\"\nmarket preview wooden-chair --out /tmp/wooden-chair.png\n```\n\n## Workflow\n\n1. Search first unless the user already gave an exact asset name. `search` requires `--type`; use `model` unless the user names another supported type: `humanoid-model`, `texture`, `humanoid-animation`, `template`, `sound-effect`, `background-music`, `environment`, or `flipbook`.\n2. Use `--limit 1` for lookup, `--limit 3` for choice. Search caps at 5 and prints full descriptions.\n3. `install` takes one or more exact asset names (optionally `name@range`); it does not search or generate. Find names with `search` first. No `--type` is needed \u2014 asset names are unique.\n4. `preview <name>` saves the preview image; no `--type` is needed. Not every type has previews (e.g. `humanoid-animation`, `template`, `sound-effect`, `background-music`); the CLI reports when one is unavailable.\n5. Use `--unapproved` only when the user asks for unapproved/private/admin assets. Do not install unapproved assets without explicit acceptance.\n6. `generate --type <type> \"<prompt>\"` creates a new asset; it requires login and a type that supports generation. No asset type currently supports generation.\n7. Upload only when publishing is requested: `market upload <name> <zip> \"<description>\" --type <type>`. Declare dependencies with repeatable flags: `--npm name@range`, `--asset name@range`, `--skill label=source`. A skill source is a `skills add` argument: a whole repo (`owner/repo` or a git URL), a single skill via the full URL form `https://github.com/owner/repo/tree/<branch>/<subpath>` (the `tree/<branch>/<subpath>` shorthand needs the full URL, not `owner/repo`), or a local path to a skill directory inside the zip. Example: `market upload my-scene scene.zip \"A scene\" --type model --npm three@^0.178.0 --skill web-design=https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines`.\n8. Installed `environment` assets contain `public/environment/<name>.hdr` for Three.js IBL lighting and `public/environment/<name>-background.webp` for the visible equirectangular background. Use `market preview` to fetch the preview image separately.\n9. Installed `flipbook` assets contain `public/flipbook/<name>.ktx2`. Render them with `@drawcall/flipbook`'s `Flipbook` class; `market preview` fetches the middle frame from the flipbook.\n\n## Humanoid animations\n\n`humanoid-animation` assets are single-clip GLBs \u2014 one motion per asset (one idle, one walk-forward, one jump, one attack) on a normalized skeleton that retargets onto any humanoid, whatever its role. A behaving character is therefore a *set* of clips, not one asset: from what the character actually does, budget the clips it needs \u2014 an idle, its locomotion (walk/run, often split by direction: fwd/bwd/left/right), and one clip per distinct action and reaction it performs \u2014 then search for each separately.\n\nSearch one motion per query, named by the motion, because results rank by keyword overlap: a query naming several motions at once is dominated by whichever word matches the most assets and buries the others, so real clips look like a gap when they exist. Names describe the motion, not the character \u2014 so search the motion (`\"walk forward\"`, `\"reload\"`, `\"jump\"`), not the role (`\"player run\"`, `\"boss attack\"`). If a motion finds nothing, retry with synonyms (run/jog/sprint, attack/swing/strike).\n\n## Output\n\nCommands print concise, line-oriented summaries:\n\n```text\nResults: 2/8 query=\"wooden chair\" type=model approval=approved\n- wooden-chair@1.0.0 | model | approved | Low-poly wooden chair\nInstalled:\n- wooden-chair@1.0.0 (asset)\n  description: Low-poly wooden chair\n  files:\n    public/model\n    \u2514\u2500 wooden-chair.glb\n- three@^0.178.0 (npm)\n- web-design \u2190 https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines (skill)\nSaved preview for wooden-chair@1.0.0: /tmp/wooden-chair.png\n```\n\nAssets may also declare `skill` dependencies, installed for you via the `skills` CLI (`skills add`) during `install`. Sources are either a GitHub/git ref or a local path to a skill directory shipped inside the asset. This requires `npx` to be available.\n\nIf search returns no results, try one broader noun phrase. If a command returns `Error: Not logged in...`, ask before running `market login`.\n";
 //# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,63GAgDvB,CAAA"}
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,qnJAwDvB,CAAA"}

package/dist/skill.js

@@ -17,14 +17,21 @@ market preview wooden-chair --out /tmp/wooden-chair.png
 
 ## Workflow
 
-1. Search first unless the user already gave an exact asset name. \`search\` requires \`--type\`; use \`model\` unless the user names another supported type: \`humanoid-model\`, \`texture\`, \`humanoid-animation\`, \`template\`, \`sound-effect\`, \`background-music\`, or \`environment\`.
-2. Use \`--limit 1\` for lookup, \`--limit 3\` for choice. Search caps at 5. Add \`--verbose\` only when the one-line descriptions are not enough.
+1. Search first unless the user already gave an exact asset name. \`search\` requires \`--type\`; use \`model\` unless the user names another supported type: \`humanoid-model\`, \`texture\`, \`humanoid-animation\`, \`template\`, \`sound-effect\`, \`background-music\`, \`environment\`, or \`flipbook\`.
+2. Use \`--limit 1\` for lookup, \`--limit 3\` for choice. Search caps at 5 and prints full descriptions.
 3. \`install\` takes one or more exact asset names (optionally \`name@range\`); it does not search or generate. Find names with \`search\` first. No \`--type\` is needed — asset names are unique.
 4. \`preview <name>\` saves the preview image; no \`--type\` is needed. Not every type has previews (e.g. \`humanoid-animation\`, \`template\`, \`sound-effect\`, \`background-music\`); the CLI reports when one is unavailable.
 5. Use \`--unapproved\` only when the user asks for unapproved/private/admin assets. Do not install unapproved assets without explicit acceptance.
 6. \`generate --type <type> "<prompt>"\` creates a new asset; it requires login and a type that supports generation. No asset type currently supports generation.
 7. Upload only when publishing is requested: \`market upload <name> <zip> "<description>" --type <type>\`. Declare dependencies with repeatable flags: \`--npm name@range\`, \`--asset name@range\`, \`--skill label=source\`. A skill source is a \`skills add\` argument: a whole repo (\`owner/repo\` or a git URL), a single skill via the full URL form \`https://github.com/owner/repo/tree/<branch>/<subpath>\` (the \`tree/<branch>/<subpath>\` shorthand needs the full URL, not \`owner/repo\`), or a local path to a skill directory inside the zip. Example: \`market upload my-scene scene.zip "A scene" --type model --npm three@^0.178.0 --skill web-design=https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines\`.
 8. Installed \`environment\` assets contain \`public/environment/<name>.hdr\` for Three.js IBL lighting and \`public/environment/<name>-background.webp\` for the visible equirectangular background. Use \`market preview\` to fetch the preview image separately.
+9. Installed \`flipbook\` assets contain \`public/flipbook/<name>.ktx2\`. Render them with \`@drawcall/flipbook\`'s \`Flipbook\` class; \`market preview\` fetches the middle frame from the flipbook.
+
+## Humanoid animations
+
+\`humanoid-animation\` assets are single-clip GLBs — one motion per asset (one idle, one walk-forward, one jump, one attack) on a normalized skeleton that retargets onto any humanoid, whatever its role. A behaving character is therefore a *set* of clips, not one asset: from what the character actually does, budget the clips it needs — an idle, its locomotion (walk/run, often split by direction: fwd/bwd/left/right), and one clip per distinct action and reaction it performs — then search for each separately.
+
+Search one motion per query, named by the motion, because results rank by keyword overlap: a query naming several motions at once is dominated by whichever word matches the most assets and buries the others, so real clips look like a gap when they exist. Names describe the motion, not the character — so search the motion (\`"walk forward"\`, \`"reload"\`, \`"jump"\`), not the role (\`"player run"\`, \`"boss attack"\`). If a motion finds nothing, retry with synonyms (run/jog/sprint, attack/swing/strike).
 
 ## Output
 
@@ -35,6 +42,7 @@ Results: 2/8 query="wooden chair" type=model approval=approved
 - wooden-chair@1.0.0 | model | approved | Low-poly wooden chair
 Installed:
 - wooden-chair@1.0.0 (asset)
+  description: Low-poly wooden chair
   files:
     public/model
     └─ wooden-chair.glb

package/dist/skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgD1B,CAAA"}
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwD1B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawcall/market",
-  "version": "0.1.32",
+  "version": "0.1.34",
   "repository": {
     "type": "git",
     "url": "https://github.com/drawcall-ai/market",

package/src/cli.ts

@@ -96,7 +96,6 @@ program
   .addOption(apiOption)
   .option('--unapproved', 'Include unapproved versions', false)
   .option('--limit <n>', 'Max results, 1-5', parseSearchLimit, 5)
-  .option('--verbose', 'Show longer descriptions', false)
   .action(
     async (
       query: string,
@@ -105,7 +104,6 @@ program
         api?: string
         unapproved: boolean
         limit: number
-        verbose: boolean
       },
     ) => {
       requireType(opts.type, 'Search')
@@ -114,7 +112,6 @@ program
         baseUrl: opts.api,
         unapproved: opts.unapproved,
         limit: opts.limit,
-        verbose: opts.verbose,
       })
     },
   )

package/src/commands/search.ts

@@ -10,7 +10,6 @@ export interface SearchCommandOptions {
   unapproved?: boolean
   baseUrl?: string
   limit?: number
-  verbose?: boolean
 }
 
 export async function searchCommand(query: string, opts: SearchCommandOptions): Promise<void> {
@@ -52,6 +51,6 @@ export async function searchCommand(query: string, opts: SearchCommandOptions):
   }
 
   for (const item of results.items) {
-    console.log(assetSearchResultLine(item, { verbose: opts.verbose ?? false }))
+    console.log(assetSearchResultLine(item))
   }
 }

package/src/commands/upload.ts

@@ -3,9 +3,14 @@ import * as path from 'path'
 import ora from 'ora'
 import semver from 'semver'
 import { getCliClient } from '../cli-client.js'
-import { MAX_UPLOAD_ZIP_SIZE_BYTES } from '../schemas.js'
+import { MAX_ASSET_DESCRIPTION_LENGTH, MAX_UPLOAD_ZIP_SIZE_BYTES } from '../schemas.js'
 import { unchangedUploadResult, uploadResult } from '../output.js'
-import { assetNameSchema, semverSchema, type AssetType } from '../schemas.js'
+import {
+  assetDescriptionSchema,
+  assetNameSchema,
+  semverSchema,
+  type AssetType,
+} from '../schemas.js'
 
 export interface UploadCommandOptions {
   type: AssetType
@@ -35,6 +40,7 @@ export async function uploadCommand(
   try {
     const parsedName = assetNameSchema.parse(name)
     const parsedVersion = opts.version ? semverSchema.parse(opts.version) : undefined
+    const parsedDescription = parseUploadDescription(description)
     // Parse dep flags before any network work so a malformed spec fails fast.
     const npmDependencies = parseVersionedDeps(opts.npm ?? [], 'npm')
     const assetDependencies = parseVersionedDeps(opts.asset ?? [], 'asset')
@@ -69,7 +75,7 @@ export async function uploadCommand(
       })
       const latestBytes = new Uint8Array(await latestZip.arrayBuffer())
       if (
-        existing.description === description &&
+        existing.description === parsedDescription &&
         depsEqual(existing.npmDependencies, npmDependencies) &&
         depsEqual(existing.assetDependencies, assetDependencies) &&
         depsEqual(existing.skillDependencies, skillDependencies) &&
@@ -87,7 +93,7 @@ export async function uploadCommand(
       name: parsedName,
       type,
       version,
-      description,
+      description: parsedDescription,
       npmDependencies,
       assetDependencies,
       skillDependencies,
@@ -105,6 +111,16 @@ export async function uploadCommand(
   }
 }
 
+export function parseUploadDescription(description: string): string {
+  try {
+    return assetDescriptionSchema.parse(description)
+  } catch {
+    throw new Error(
+      `Asset description must be ${MAX_ASSET_DESCRIPTION_LENGTH} characters or fewer.`,
+    )
+  }
+}
+
 /**
  * Parse `name@range` specs (npm or asset deps) into a name→range record. The
  * range is optional and defaults to `*`. A leading `@` is treated as a scope

package/src/constants.ts

@@ -11,7 +11,7 @@ export const ALLOWED_EXTENSIONS: Record<AssetType, string[]> = {
   'sound-effect': ['.zip'],
   'background-music': ['.zip'],
   environment: ['.zip'],
-  tutorial: ['.zip'],
+  flipbook: ['.zip'],
 }
 
 export const ASSET_TYPE_LABELS: Record<AssetType, string> = {
@@ -23,5 +23,5 @@ export const ASSET_TYPE_LABELS: Record<AssetType, string> = {
   'sound-effect': 'Sound Effect',
   'background-music': 'Background Music',
   environment: 'Environment',
-  tutorial: 'Tutorial',
+  flipbook: 'Flipbook',
 }

package/src/install.ts

@@ -42,6 +42,7 @@ export interface InstalledAsset {
   name: string
   type: string
   version: string
+  description: string | null
   files: string[]
 }
 
@@ -139,6 +140,7 @@ async function downloadAssets(
       name: asset.name,
       type: asset.type,
       version: asset.version,
+      description: asset.description,
       files: installedFiles,
     })
 

package/src/output.ts

@@ -24,13 +24,8 @@ export function searchSummary(input: {
   return `Results: ${input.count}/${input.total} ${scope}`
 }
 
-export function assetSearchResultLine(
-  item: AssetSearchResult,
-  opts: { verbose?: boolean } = {},
-): string {
-  const description = item.description
-    ? ` | ${compact(item.description, opts.verbose ? 160 : 80)}`
-    : ''
+export function assetSearchResultLine(item: AssetSearchResult): string {
+  const description = item.description ? ` | ${normalizeInline(item.description)}` : ''
   return `- ${assetVersionRef(item.name, item.latestVersion)} | ${item.type} | ${assetApproval(
     item.approved,
   )}${description}`
@@ -47,12 +42,15 @@ export function installResult(
   for (const asset of result.assets) {
     const files = unique(asset.files)
     lines.push(`- ${assetVersionRef(asset.name, asset.version)} (${asset.type})`)
+    if (asset.description) {
+      lines.push(...block('  description: ', asset.description))
+    }
     if (files.length > 0) {
       lines.push('  files:', ...indent(fileTree(files), '    '))
     }
     const message = postInstallMessages[asset.type]
     if (message) {
-      lines.push(...note(message))
+      lines.push(...block('  note: ', message))
     }
   }
 
@@ -76,14 +74,9 @@ export function installResult(
   return lines.join('\n')
 }
 
-/**
- * Render an asset's post-install message as a `note:` block, word-wrapped with a
- * hanging indent so continuation lines align under the message text.
- */
-function note(message: string, width = 68): string[] {
-  const label = '  note: '
+function block(label: string, message: string, width = 68): string[] {
   const hang = ' '.repeat(label.length)
-  const words = message.split(/\s+/).filter(Boolean)
+  const words = normalizeInline(message).split(' ').filter(Boolean)
 
   const wrapped: string[] = []
   let line = ''
@@ -129,10 +122,14 @@ export function errorResult(message: string): string {
 }
 
 export function compact(value: string, max = 96): string {
-  const normalized = value.replace(/\s+/g, ' ').trim()
+  const normalized = normalizeInline(value)
   return normalized.length > max ? normalized.slice(0, max - 3) + '...' : normalized
 }
 
+function normalizeInline(value: string): string {
+  return value.replace(/\s+/g, ' ').trim()
+}
+
 interface FileTreeNode {
   children: Map<string, FileTreeNode>
 }

package/src/resolve.ts

@@ -17,6 +17,7 @@ export interface ResolvedAsset {
   name: string
   type: string
   version: string
+  description: string | null
   npmDependencies: Record<string, string>
   assetDependencies: Record<string, string>
   skillDependencies: Record<string, string>
@@ -88,6 +89,7 @@ export async function resolve(
         name: assetName,
         type: meta.type,
         version: meta.latestVersion,
+        description: meta.description,
         npmDependencies: npmDeps,
         assetDependencies: assetDeps,
         skillDependencies: skillDeps,

package/src/schemas.ts

@@ -9,13 +9,14 @@ export const ASSET_TYPES = [
   'sound-effect',
   'background-music',
   'environment',
-  'tutorial',
+  'flipbook',
 ] as const
 export type AssetType = (typeof ASSET_TYPES)[number]
 
 export const assetTypeSchema = z.enum(ASSET_TYPES)
 
 export const MAX_UPLOAD_ZIP_SIZE_BYTES = 1024 * 1024 * 1024
+export const MAX_ASSET_DESCRIPTION_LENGTH = 1000
 
 export const semverSchema = z
   .string()
@@ -45,6 +46,8 @@ export const assetDependenciesSchema = z.record(z.string(), z.string()).default(
 // shipped inside the asset.
 export const skillDependenciesSchema = z.record(z.string(), z.string()).default({})
 
+export const assetDescriptionSchema = z.string().max(MAX_ASSET_DESCRIPTION_LENGTH)
+
 export const updateProfileSchema = z.object({
   name: z.string().min(1).max(100).optional(),
   image: z.string().url().optional(),
@@ -69,7 +72,7 @@ export const uploadZipSchema = z.object({
   name: assetNameSchema,
   type: assetTypeSchema,
   version: semverSchema,
-  description: z.string().max(1000).optional(),
+  description: assetDescriptionSchema.optional(),
   npmDependencies: npmDependenciesSchema,
   assetDependencies: assetDependenciesSchema,
   skillDependencies: skillDependenciesSchema,
@@ -82,6 +85,6 @@ export const downloadZipSchema = z.object({
 })
 
 export const generateAssetSchema = z.object({
-  description: z.string().min(3).max(1000),
+  description: assetDescriptionSchema.min(3),
   type: assetTypeSchema.optional(),
 })

package/src/skill.ts

@@ -17,14 +17,21 @@ market preview wooden-chair --out /tmp/wooden-chair.png
 
 ## Workflow
 
-1. Search first unless the user already gave an exact asset name. \`search\` requires \`--type\`; use \`model\` unless the user names another supported type: \`humanoid-model\`, \`texture\`, \`humanoid-animation\`, \`template\`, \`sound-effect\`, \`background-music\`, or \`environment\`.
-2. Use \`--limit 1\` for lookup, \`--limit 3\` for choice. Search caps at 5. Add \`--verbose\` only when the one-line descriptions are not enough.
+1. Search first unless the user already gave an exact asset name. \`search\` requires \`--type\`; use \`model\` unless the user names another supported type: \`humanoid-model\`, \`texture\`, \`humanoid-animation\`, \`template\`, \`sound-effect\`, \`background-music\`, \`environment\`, or \`flipbook\`.
+2. Use \`--limit 1\` for lookup, \`--limit 3\` for choice. Search caps at 5 and prints full descriptions.
 3. \`install\` takes one or more exact asset names (optionally \`name@range\`); it does not search or generate. Find names with \`search\` first. No \`--type\` is needed — asset names are unique.
 4. \`preview <name>\` saves the preview image; no \`--type\` is needed. Not every type has previews (e.g. \`humanoid-animation\`, \`template\`, \`sound-effect\`, \`background-music\`); the CLI reports when one is unavailable.
 5. Use \`--unapproved\` only when the user asks for unapproved/private/admin assets. Do not install unapproved assets without explicit acceptance.
 6. \`generate --type <type> "<prompt>"\` creates a new asset; it requires login and a type that supports generation. No asset type currently supports generation.
 7. Upload only when publishing is requested: \`market upload <name> <zip> "<description>" --type <type>\`. Declare dependencies with repeatable flags: \`--npm name@range\`, \`--asset name@range\`, \`--skill label=source\`. A skill source is a \`skills add\` argument: a whole repo (\`owner/repo\` or a git URL), a single skill via the full URL form \`https://github.com/owner/repo/tree/<branch>/<subpath>\` (the \`tree/<branch>/<subpath>\` shorthand needs the full URL, not \`owner/repo\`), or a local path to a skill directory inside the zip. Example: \`market upload my-scene scene.zip "A scene" --type model --npm three@^0.178.0 --skill web-design=https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines\`.
 8. Installed \`environment\` assets contain \`public/environment/<name>.hdr\` for Three.js IBL lighting and \`public/environment/<name>-background.webp\` for the visible equirectangular background. Use \`market preview\` to fetch the preview image separately.
+9. Installed \`flipbook\` assets contain \`public/flipbook/<name>.ktx2\`. Render them with \`@drawcall/flipbook\`'s \`Flipbook\` class; \`market preview\` fetches the middle frame from the flipbook.
+
+## Humanoid animations
+
+\`humanoid-animation\` assets are single-clip GLBs — one motion per asset (one idle, one walk-forward, one jump, one attack) on a normalized skeleton that retargets onto any humanoid, whatever its role. A behaving character is therefore a *set* of clips, not one asset: from what the character actually does, budget the clips it needs — an idle, its locomotion (walk/run, often split by direction: fwd/bwd/left/right), and one clip per distinct action and reaction it performs — then search for each separately.
+
+Search one motion per query, named by the motion, because results rank by keyword overlap: a query naming several motions at once is dominated by whichever word matches the most assets and buries the others, so real clips look like a gap when they exist. Names describe the motion, not the character — so search the motion (\`"walk forward"\`, \`"reload"\`, \`"jump"\`), not the role (\`"player run"\`, \`"boss attack"\`). If a motion finds nothing, retry with synonyms (run/jog/sprint, attack/swing/strike).
 
 ## Output
 
@@ -35,6 +42,7 @@ Results: 2/8 query="wooden chair" type=model approval=approved
 - wooden-chair@1.0.0 | model | approved | Low-poly wooden chair
 Installed:
 - wooden-chair@1.0.0 (asset)
+  description: Low-poly wooden chair
   files:
     public/model
     └─ wooden-chair.glb

package/tests/install-layout.test.ts

@@ -29,6 +29,7 @@ test('install writes zip files into the package root', async () => {
           name: 'idle-loop',
           type: 'humanoid-animation',
           version: '1.0.0',
+          description: 'Idle loop animation',
           npmDependencies: {},
           assetDependencies: {},
           skillDependencies: {},
@@ -46,6 +47,7 @@ test('install writes zip files into the package root', async () => {
         name: 'idle-loop',
         type: 'humanoid-animation',
         version: '1.0.0',
+        description: 'Idle loop animation',
         files: ['public/humanoid-animation/idle-loop.glb', 'src/generated/idle-loop.ts'],
       },
     ],
@@ -77,8 +79,9 @@ test('install rejects zip paths that escape through parent segments', async () =
         assets: [
           {
             name: 'bad-path',
-          type: 'template',
+            type: 'template',
             version: '1.0.0',
+            description: null,
             npmDependencies: {},
             assetDependencies: {},
             skillDependencies: {},
@@ -112,6 +115,7 @@ test('install runs the skills runner per dependency, resolving local paths again
           name: 'with-skills',
           type: 'template',
           version: '1.0.0',
+          description: null,
           npmDependencies: {},
           assetDependencies: {},
           skillDependencies: {},

package/tests/output.test.ts

@@ -1,6 +1,30 @@
 import assert from 'node:assert/strict'
 import test from 'node:test'
-import { installResult } from '../src/output.js'
+import { assetSearchResultLine, installResult } from '../src/output.js'
+
+test('assetSearchResultLine prints the full description', () => {
+  const description =
+    'A detailed model description that is intentionally longer than the old one-line search cap, with material notes, scale guidance, and usage context.'
+
+  assert.equal(
+    assetSearchResultLine({
+      id: 'asset-1',
+      name: 'wooden-chair',
+      type: 'model',
+      description,
+      ownerId: 'user-1',
+      createdAt: new Date('2026-01-01T00:00:00.000Z'),
+      updatedAt: new Date('2026-01-01T00:00:00.000Z'),
+      latestVersion: '1.2.0',
+      approved: true,
+      npmDependencies: '{}',
+      assetDependencies: '{}',
+      skillDependencies: '{}',
+      previewUrl: null,
+    }),
+    `- wooden-chair@1.2.0 | model | approved | ${description}`,
+  )
+})
 
 test('installResult prints asset type, file tree, and npm list', () => {
   assert.equal(
@@ -10,12 +34,14 @@ test('installResult prints asset type, file tree, and npm list', () => {
           name: 'wooden-chair',
           type: 'model',
           version: '1.2.0',
+          description: null,
           files: ['public/models/wooden-chair.glb'],
         },
         {
           name: 'oak-material',
           type: 'texture',
           version: '1.0.0',
+          description: null,
           files: ['public/textures/oak/basecolor.png', 'public/textures/oak/normal.png'],
         },
       ],
@@ -44,8 +70,20 @@ test('installResult attaches each post-install note under its asset', () => {
     installResult(
       {
         assets: [
-          { name: 'wooden-chair', type: 'model', version: '1.2.0', files: [] },
-          { name: 'beep', type: 'sound-effect', version: '1.0.0', files: [] },
+          {
+            name: 'wooden-chair',
+            type: 'model',
+            version: '1.2.0',
+            description: null,
+            files: [],
+          },
+          {
+            name: 'beep',
+            type: 'sound-effect',
+            version: '1.0.0',
+            description: null,
+            files: [],
+          },
         ],
         npmDependencies: {},
         skillDependencies: {},
@@ -66,7 +104,7 @@ test('installResult word-wraps a long note with a hanging indent', () => {
   const message = Array(20).fill('word').join(' ')
   const output = installResult(
     {
-      assets: [{ name: 'thing', type: 'model', version: '1.0.0', files: [] }],
+      assets: [{ name: 'thing', type: 'model', version: '1.0.0', description: null, files: [] }],
       npmDependencies: {},
       skillDependencies: {},
     },
@@ -85,7 +123,15 @@ test('installResult word-wraps a long note with a hanging indent', () => {
 test('installResult lists installed skills with their source', () => {
   assert.equal(
     installResult({
-      assets: [{ name: 'wooden-chair', type: 'model', version: '1.2.0', files: [] }],
+      assets: [
+        {
+          name: 'wooden-chair',
+          type: 'model',
+          version: '1.2.0',
+          description: null,
+          files: [],
+        },
+      ],
       npmDependencies: {},
       skillDependencies: {
         'web-design-guidelines': 'vercel-labs/agent-skills/tree/main/skills/web-design-guidelines',
@@ -98,3 +144,26 @@ test('installResult lists installed skills with their source', () => {
 - web-design-guidelines ← vercel-labs/agent-skills/tree/main/skills/web-design-guidelines (skill)`,
   )
 })
+
+test('installResult shows each installed asset description', () => {
+  assert.equal(
+    installResult({
+      assets: [
+        {
+          name: 'wooden-chair',
+          type: 'model',
+          version: '1.2.0',
+          description:
+            'A game-ready chair with baked texture detail and clean origin placement for room scenes.',
+          files: [],
+        },
+      ],
+      npmDependencies: {},
+      skillDependencies: {},
+    }),
+    `Installed:
+- wooden-chair@1.2.0 (model)
+  description: A game-ready chair with baked texture detail and clean origin
+               placement for room scenes.`,
+  )
+})

package/tests/upload-deps.test.ts

@@ -1,6 +1,11 @@
 import assert from 'node:assert/strict'
 import test from 'node:test'
-import { parseSkillDeps, parseVersionedDeps } from '../src/commands/upload.js'
+import {
+  parseSkillDeps,
+  parseUploadDescription,
+  parseVersionedDeps,
+} from '../src/commands/upload.js'
+import { MAX_ASSET_DESCRIPTION_LENGTH } from '../src/schemas.js'
 
 test('parseVersionedDeps parses name@range and defaults a missing range to *', () => {
   assert.deepEqual(parseVersionedDeps(['three@^0.178.0', 'gsap'], 'npm'), {
@@ -17,7 +22,10 @@ test('parseVersionedDeps keeps the scope marker on scoped npm packages', () => {
 })
 
 test('parseVersionedDeps rejects duplicates', () => {
-  assert.throws(() => parseVersionedDeps(['three@^1', 'three@^2'], 'npm'), /Duplicate npm dependency/u)
+  assert.throws(
+    () => parseVersionedDeps(['three@^1', 'three@^2'], 'npm'),
+    /Duplicate npm dependency/u,
+  )
 })
 
 test('parseSkillDeps splits label=source on the first = only', () => {
@@ -42,3 +50,14 @@ test('parseSkillDeps rejects specs without a usable label=source', () => {
 test('parseSkillDeps rejects duplicate labels', () => {
   assert.throws(() => parseSkillDeps(['a=one', 'a=two']), /Duplicate skill dependency "a"/u)
 })
+
+test('parseUploadDescription rejects descriptions beyond the shared max length', () => {
+  assert.equal(
+    parseUploadDescription('A compact asset description.'),
+    'A compact asset description.',
+  )
+  assert.throws(
+    () => parseUploadDescription('x'.repeat(MAX_ASSET_DESCRIPTION_LENGTH + 1)),
+    /1000 characters or fewer/u,
+  )
+})