fashion-design-ref 1.0.0

package/README.md

@@ -0,0 +1,43 @@
+# fashion-design-ref
+
+A Claude Code skill that gives you instant access to 17,000+ Vogue Runway garments (2020–2024) for fashion design references — plus auto-generated image prompts for AI image generation.
+
+## Install
+
+```bash
+npm install -g fashion-design-ref
+```
+
+The skill is automatically placed in `~/.claudecode/skills/fashion-design-ref/` after install.
+
+## Usage in Claude Code
+
+Just describe what you need in natural language — Chinese or English:
+
+```
+帮我找31岁大学女老师、品质高的衬衫设计参考
+Find oversized deconstructed jacket references, avant-garde aesthetic
+20岁女生甜美风连衣裙，春夏
+Show me quiet luxury coat references from top brands
+```
+
+Claude Code will:
+1. Search the database for real historical garments matching your description
+2. Return reference garments with brand, year, design elements, and editorial descriptions
+3. Generate a ready-to-use image prompt for nano banana or any AI image generator
+
+## What's in the database
+
+- **17,193 garments** from Vogue Runway 2020–2024
+- **100 brands**: Chanel, Dior, Prada, Gucci, The Row, Rick Owens, Maison Margiela, and more
+- **9 style categories**: french-luxury, italian-luxury, conceptual, quiet-luxury, contemporary, romantic, streetwear, heritage-tailoring, british-american
+- **13 design dimensions**: silhouette, construction, neckline, material, pattern, color palette, occasion, cultural reference...
+
+## API
+
+The skill connects to a hosted API at `http://ec2-18-144-67-51.us-west-1.compute.amazonaws.com:8001`.
+
+You can also call it directly:
+```bash
+python3 ~/.claudecode/skills/fashion-design-ref/scripts/search.py "your query" --limit 5
+```

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "fashion-design-ref",
+  "version": "1.0.0",
+  "description": "Fashion design reference skill for Claude Code — search 17,000+ Vogue Runway garments and generate image prompts",
+  "keywords": ["claude", "claudecode", "skill", "fashion", "design", "reference", "vogue", "runway"],
+  "homepage": "https://github.com/ChongC1990/fashion-design-db",
+  "license": "MIT",
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "files": [
+    "postinstall.js",
+    "skill/"
+  ],
+  "engines": {
+    "node": ">=16"
+  }
+}

package/postinstall.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * postinstall.js — copy skill files to ~/.claudecode/skills/fashion-design-ref/
+ */
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const SKILL_NAME = "fashion-design-ref";
+const SRC = path.join(__dirname, "skill");
+const DEST = path.join(os.homedir(), ".claudecode", "skills", SKILL_NAME);
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+try {
+  copyDir(SRC, DEST);
+  console.log(`✅ Fashion Design Reference skill installed to ${DEST}`);
+  console.log(`   Usage in Claude Code: "帮我找女装衬衫设计参考" or "fashion reference for oversized jacket"`);
+} catch (err) {
+  console.error(`❌ Failed to install skill: ${err.message}`);
+  process.exit(1);
+}

package/skill/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: fashion-design-ref
+description: Fashion design reference search powered by a curated database of 17,000+ Vogue Runway garments (2020-2024). Given a natural language description of a design need, searches for real historical reference garments and returns structured design elements plus a ready-to-use image generation prompt for nano banana. Use when a user asks for: fashion design references, clothing inspiration, garment design ideas, style references for a specific person/occasion/aesthetic, or wants to generate fashion images. Triggers on keywords like "design reference", "fashion reference", "衬衫设计", "服装灵感", "生成衣服", "设计参考", "风格参考".
+---
+
+# Fashion Design Reference
+
+Search 17,000+ Vogue Runway garments for design references and generate image prompts.
+
+## API
+
+Base URL: `http://ec2-18-144-67-51.us-west-1.compute.amazonaws.com:8001`
+
+### Search
+
+```
+POST /v1/fashion/search
+{"query": "<natural language>", "limit": 5}
+```
+
+Response fields:
+- `results[]` — real garment records from DB (id, brand, name, year, category, description, elements)
+- `image_prompt` — ready-to-use nano banana prompt (flat lay, no people, front+back+detail)
+- `design_insight` — Gemini synthesis of what the references suggest
+- `interpretation` — how the query was understood
+
+Supports Chinese and English queries. Auto-detects gender, category (coat/shirt/dress/skirt/trousers/knitwear), occasion.
+
+### Other endpoints
+
+```
+GET  /v1/fashion/garments/{id}          # single garment detail
+GET  /v1/fashion/similar/{id}?limit=5   # similar garments by tag overlap
+POST /v1/fashion/elements               # element co-occurrence suggestions
+     {"elements": ["tailored", "oversized"], "category": "jacket"}
+GET  /v1/fashion/health                 # health check
+```
+
+## Workflow
+
+1. Call `POST /v1/fashion/search` with the user's query — use `scripts/search.py`
+2. Present the reference garments with brand/year/description
+3. Show the `image_prompt` to the user — they can pass it directly to nano banana
+4. Optionally call nano banana to generate the image inline
+
+See `references/api.md` for full field schemas and element vocabulary.
+
+## Running the search script
+
+```bash
+python3 scripts/search.py "31岁大学女老师，衬衫，短款，品质高" --limit 5
+python3 scripts/search.py "oversized deconstructed jacket, avant-garde" --limit 8
+```
+
+Output: JSON with results + image_prompt printed to stdout.

package/skill/references/api.md

@@ -0,0 +1,80 @@
+# Fashion Design Reference API
+
+Base URL: `http://ec2-18-144-67-51.us-west-1.compute.amazonaws.com:8001`
+
+## POST /v1/fashion/search
+
+**Request:**
+```json
+{
+  "query": "string (Chinese or English)",
+  "limit": 5,
+  "filters": {
+    "category": "coat|jacket|shirt|dress|skirt|trousers|knitwear|outerwear",
+    "gender": "women|men|unisex",
+    "year_from": 2018,
+    "year_to": 2024
+  }
+}
+```
+
+**Response:**
+```json
+{
+  "interpretation": "How the query was understood",
+  "search_strategy": "Which tags were matched",
+  "results": [
+    {
+      "id": 3569,
+      "name": "Military-Inspired Utility Shirt",
+      "brand": "Prada",
+      "designer": null,
+      "year": 2024,
+      "season": "FW",
+      "collection_name": null,
+      "category": "shirt",
+      "description": "Miuccia Prada and Raf Simons...",
+      "elements": {
+        "silhouette": ["relaxed", "oversized"],
+        "construction": ["tailored"],
+        "neckline": ["notched-lapel"],
+        "color_palette": ["neutral", "earth-tone"],
+        "occasion": ["workwear", "casual"]
+      },
+      "relevance_note": "Matched via design element tags"
+    }
+  ],
+  "design_insight": "Synthesis of what references suggest",
+  "image_prompt": "Ready-to-use nano banana prompt...",
+  "alternative_directions": ["Direction 1", "Direction 2"]
+}
+```
+
+## Design Element Vocabulary
+
+| Dimension | Values |
+|-----------|--------|
+| silhouette | oversized, boxy, fitted, relaxed, column, wide-leg, flared, tapered, cocoon, A-line, balloon, asymmetric, draped |
+| construction | tailored, deconstructed, draped, raw-edge, basted, quilted, smocked, pleated, gathered, bonded, laser-cut |
+| neckline | crew, V-neck, notched-lapel, shawl-lapel, mandarin, cowl, off-shoulder, square, deep-plunge, turtleneck, asymmetric, no-collar |
+| sleeve | set-in, raglan, dropped, bishop, puff, sleeveless, dolman, kimono, three-quarter, long |
+| closure | buttons, zipper, hook-and-eye, wrap, no-closure, lace-up, press-stud, drawstring |
+| hem | straight, asymmetric, high-low, curved, raw, stepped, tiered, handkerchief |
+| material_weight | lightweight, medium, heavy, structured, fluid |
+| material_texture | smooth, textured, sheer, quilted, knit, matte, glossy, napped, open-weave |
+| pattern | solid, stripe, plaid, floral, abstract, geometric, animal-print, herringbone, houndstooth, tweed, jacquard, check |
+| color_palette | monochrome, neutral, earth-tone, contrast, tonal, multicolor, neon, pastel, dark |
+| detailing | exposed-seam, patch-pocket, pleats, pintuck, embroidery, applique, fringe, hardware, cutout, vent, ruching, welt-pocket, peplum, topstitching |
+| occasion | streetwear, formal, casual, workwear, eveningwear, avant-garde, resort, couture, sportswear |
+| cultural_reference | military, workwear, tailoring, japanese, streetwear, punk, folk, futurism, romanticism, sportswear, couture, minimalism |
+
+## Categories
+
+`jacket` `coat` `shirt` `dress` `skirt` `trousers` `knitwear` `outerwear` `footwear` `accessory`
+
+## Database Coverage
+
+- **17,193 garments** from Vogue Runway 2020–2024
+- **100 brands** across 9 style categories
+- **Top brands by volume**: Louis Vuitton (429), Fendi (426), Saint Laurent (417), Gucci (400), Valentino (381), Prada (377), Givenchy (377)
+- **Style categories**: french-luxury, italian-luxury, british-american, conceptual, quiet-luxury, contemporary, streetwear, romantic, heritage-tailoring

package/skill/scripts/search.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""
+Fashion Design Reference Search
+Usage: python3 search.py "<query>" [--limit N] [--base-url URL]
+"""
+
+import sys
+import json
+import argparse
+import urllib.request
+import urllib.error
+
+DEFAULT_BASE_URL = "http://ec2-18-144-67-51.us-west-1.compute.amazonaws.com:8001"
+
+
+def search(query: str, limit: int = 5, base_url: str = DEFAULT_BASE_URL) -> dict:
+    payload = json.dumps({"query": query, "limit": limit}).encode()
+    req = urllib.request.Request(
+        f"{base_url}/v1/fashion/search",
+        data=payload,
+        headers={"Content-Type": "application/json"},
+        method="POST",
+    )
+    try:
+        with urllib.request.urlopen(req, timeout=90) as r:
+            return json.load(r)
+    except urllib.error.HTTPError as e:
+        return {"error": f"HTTP {e.code}: {e.read().decode()[:200]}"}
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def pretty_print(result: dict):
+    if "error" in result:
+        print(f"Error: {result['error']}", file=sys.stderr)
+        return
+
+    print(f"\n📖 Interpretation: {result.get('interpretation', '')}")
+    print(f"🔍 Strategy: {result.get('search_strategy', '')}\n")
+
+    results = result.get("results", [])
+    print(f"Found {len(results)} reference garments:\n")
+    for i, g in enumerate(results, 1):
+        print(f"[{i}] {g.get('brand', '?')} — {g.get('name', '?')}")
+        print(f"     {g.get('year', '?')} {g.get('season', '')} | {g.get('category', '?')}")
+        print(f"     {g.get('description', '')[:150]}...")
+        elems = g.get("elements", {})
+        if elems:
+            key_dims = ["silhouette", "construction", "material_texture", "color_palette", "occasion"]
+            tags = []
+            for dim in key_dims:
+                vals = elems.get(dim, [])
+                if vals:
+                    tags.append(f"{dim}: {', '.join(vals)}")
+            if tags:
+                print(f"     Tags: {' | '.join(tags)}")
+        print()
+
+    if result.get("design_insight"):
+        print(f"💡 Design Insight:\n{result['design_insight']}\n")
+
+    if result.get("image_prompt"):
+        print(f"🎨 Image Prompt (nano banana ready):\n{result['image_prompt']}\n")
+
+    if result.get("alternative_directions"):
+        print("↗  Alternative Directions:")
+        for d in result["alternative_directions"]:
+            print(f"   - {d}")
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="Fashion design reference search")
+    parser.add_argument("query", help="Natural language design query (Chinese or English)")
+    parser.add_argument("--limit", type=int, default=5, help="Number of results (default: 5)")
+    parser.add_argument("--base-url", default=DEFAULT_BASE_URL, help="API base URL")
+    parser.add_argument("--json", action="store_true", help="Output raw JSON")
+    args = parser.parse_args()
+
+    result = search(args.query, args.limit, args.base_url)
+
+    if args.json:
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+    else:
+        pretty_print(result)