[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7D7NF0BAA30E73ZMPSMBR8K":3,"skill-same:01M7D7NF0BAA30E73ZMPSMBR8K":58},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":5,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7D7NF0BAA30E73ZMPSMBR8K","huggingface-best",null,"Use when the user asks about finding the best, top, or recommended model for a task, wants to know what AI model to use, or wants to compare models by benchmark scores. Triggers on: \"best model for X\", \"what model should I use for\", \"top models for [task]\", \"which model runs on my laptop\u002Fmachine\u002Fdevice\", \"recommend a model for\", \"what LLM should I use for\", \"compare models for\", \"what's state of the art for\", or any question about choosing an AI model for a specific use case. Always use this skill when the user wants model recommendations or comparisons, even if they don't explicitly mention HuggingFace or benchmarks.","tangyixiao\u002Ftangyixiao-skills","tangyixiao","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F115929632?v=4","01M7D582YK6A4M63CAK4CSY4EW","Tang Yixiao","01M7D582Z64DMRSYR872SR34SA",2,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fhuggingface-best\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fhuggingface-best\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: huggingface-best\ndescription: 'Use when the user asks about finding the best, top, or recommended model\n  for a task, wants to know what AI model to use, or wants to compare models by benchmark\n  scores. Triggers on: \"best model for X\", \"what model should I use for\", \"top models\n  for [task]\", \"which model runs on my laptop\u002Fmachine\u002Fdevice\", \"recommend a model\n  for\", \"what LLM should I use for\", \"compare models for\", \"what''s state of the art\n  for\", or any question about choosing an AI model for a specific use case. Always\n  use this skill when the user wants model recommendations or comparisons, even if\n  they don''t explicitly mention HuggingFace or benchmarks.'\n---\n\n# HuggingFace Best Model Finder\n\nFinds the best models for a task by querying official HF benchmark leaderboards, enriching\nresults with model size data, filtering for what fits on the user's device, and returning a\ncomparison table with benchmark scores.\n\n---\n\n## Step 1: Parse the request\n\nExtract from the user's message:\n- **Task**: what they want the model to do (coding, math\u002Freasoning, chat, OCR, RAG\u002Fretrieval, speech recognition, image classification, multimodal, agents, etc.)\n- **Device**: hardware constraints (MacBook M-series 8\u002F16\u002F32\u002F64GB unified memory, RTX GPU with VRAM amount, CPU-only, cloud\u002Fno constraint, etc.)\n\nIf device is not mentioned, skip filtering entirely and return the highest-performing models regardless of size. If the task is genuinely ambiguous, ask one clarifying question.\n\n### Device → max parameter budget\n\nWhen a device is specified, extract its available memory (unified RAM for Apple Silicon, VRAM for discrete GPUs) and apply:\n\n- **fp16 max params (B)** ≈ memory (GB) ÷ 2\n- **Q4 max params (B)** ≈ memory (GB) × 2\n\nExamples: 16GB → 8B fp16 \u002F 32B Q4 — 24GB VRAM → 12B fp16 \u002F 48B Q4 — 8GB → 4B fp16 \u002F 16B Q4\n\n---\n\n## Step 2: Find relevant benchmark datasets\n\nFetch the full list of official HF benchmarks:\n\n```bash\ncurl -s -H \"Authorization: Bearer $(cat ~\u002F.cache\u002Fhuggingface\u002Ftoken)\" \\\n  \"https:\u002F\u002Fhuggingface.co\u002Fapi\u002Fdatasets?filter=benchmark:official&limit=500\" | jq '[.[] | {id, tags, description}]'\n```\n\nRead the returned list and select the datasets most relevant to the user's task — match on dataset id, tags, and description. Use your judgment; don't limit yourself to 2-3. Aim for comprehensive coverage: if 5 benchmarks clearly cover the task, use all 5.\n\n---\n\n## Step 3: Fetch top models from leaderboards\n\nFor each selected benchmark dataset:\n\n```bash\ncurl -s -H \"Authorization: Bearer $(cat ~\u002F.cache\u002Fhuggingface\u002Ftoken)\" \\\n  \"https:\u002F\u002Fhuggingface.co\u002Fapi\u002Fdatasets\u002F\u003Cnamespace>\u002F\u003Crepo>\u002Fleaderboard\" | jq '[.[:15] | .[] | {rank, modelId, value, verified}]'\n```\n\nCollect model IDs and scores across all benchmarks. If a leaderboard returns an error (404, 401, etc.), skip it and note it in the output.\n\n---\n\n## Step 4: Enrich with model metadata\n\nFor the top 10-15 candidate model IDs, get model infos.\n\n```bash\n# REST API\ncurl -s -H \"Authorization: Bearer $(cat ~\u002F.cache\u002Fhuggingface\u002Ftoken)\" \\\n  \"https:\u002F\u002Fhuggingface.co\u002Fapi\u002Fmodels\u002Forg\u002Fmodel1\" | jq '{safetensors, tags, cardData}'\n\n# CLI (hf-cli)\nhf models info org\u002Fmodel1 --json | jq '{safetensors, tags, cardData}'\n```\n\nExtract from each response:\n- **Parameters**: `safetensors.total` → convert to B (e.g., 7_241_748_480 → \"7.2B\")\n- **License**: from model card tags (look for `license:apache-2.0`, `license:mit`, etc.)\n- If `safetensors` is absent, parse size from the model name (look for \"7b\", \"8b\", \"13b\", \"70b\", \"72b\", etc.)\n\n---\n\n## Step 5: Filter and rank\n\n**If a device was specified:**\n1. Remove models exceeding the fp16 parameter budget for the device\n2. Flag models that fit only with Q4 quantization (multiply budget by ~4 for Q4 capacity)\n3. If a highly-ranked model is slightly over budget, keep it with a \"needs Q4\" note — don't silently drop it\n\n**If no device was mentioned:** skip all size filtering — just rank by benchmark score.\n\nThen: rank by benchmark score (descending), keep top 5-8 models.\n\nInclude proprietary models (GPT-4, Claude, Gemini) if they appear on leaderboards, but flag them as \"API only \u002F not self-hostable\". If the user explicitly asked for local\u002Fopen models only, exclude them.\n\n---\n\n## Step 6: Output\n\n### Comparison table\n\n```markdown\n| # | Model | Params | [Benchmark 1] | [Benchmark 2] | License | On device |\n|---|-------|--------|--------------|--------------|---------|-----------|\n| ⭐1 | [org\u002Fname](https:\u002F\u002Fhuggingface.co\u002Forg\u002Fname) | 7B | 85.2% | — | Apache 2.0 | Yes (fp16) |\n| 2 | [org\u002Fname](https:\u002F\u002Fhuggingface.co\u002Forg\u002Fname) | 13B | 83.1% | 71.5% | MIT | Q4 only |\n| 3 | [org\u002Fname](https:\u002F\u002Fhuggingface.co\u002Forg\u002Fname) | 70B | 90.0% | 81.0% | Llama | Too large |\n```\n\n- Link model names to `https:\u002F\u002Fhuggingface.co\u002F\u003Cmodel_id>`\n- Use `—` for benchmarks where the model wasn't evaluated\n- Star the top recommended pick with ⭐\n- \"On device\" values: `Yes (fp16)`, `Q4 only`, `Too large`, `API only`\n\n### Follow-up\n\nAfter presenting the table, ask the user: \"Would you like to run **[top recommended model]**?\"\n\nIf they say yes, ask whether they'd prefer to:\n- **Run locally** — ask about their device if not already known, then give appropriate setup instructions\n- **Run on HF Jobs** — point them to the HF Jobs guide: https:\u002F\u002Fhuggingface.co\u002Fdocs\u002Fhuggingface_hub\u002Fen\u002Fguides\u002Fjobs\n\n---\n\n## Error handling\n\n- **Leaderboard not found**: skip, note \"leaderboard unavailable\" in output\n- **Model missing from hub_repo_details**: fall back to parsing size from model name\n- **No benchmarks found for task**: use the curated fallback table above, or try `hub_repo_search` with `filters=[\"\u003Ctask>\"]` sorted by `trendingScore`\n- **All leaderboards fail**: fall back to `hub_repo_search` for popular models tagged with the task, note that results are by popularity rather than benchmark score\n","# HuggingFace Best Model Finder\n\nFinds the best models for a task by querying official HF benchmark leaderboards, enriching\nresults with model size data, filtering for what fits on the user's device, and returning a\ncomparison table with benchmark scores.\n\n---\n\n## Step 1: Parse the request\n\nExtract from the user's message:\n- **Task**: what they want the model to do (coding, math\u002Freasoning, chat, OCR, RAG\u002Fretrieval, speech recognition, image classification, multimodal, agents, etc.)\n- **Device**: hardware constraints (MacBook M-series 8\u002F16\u002F32\u002F64GB unified memory, RTX GPU with VRAM amount, CPU-only, cloud\u002Fno constraint, etc.)\n\nIf device is not mentioned, skip filtering entirely and return the highest-performing models regardless of size. If the task is genuinely ambiguous, ask one clarifying question.\n\n### Device → max parameter budget\n\nWhen a device is specified, extract its available memory (unified RAM for Apple Silicon, VRAM for discrete GPUs) and apply:\n\n- **fp16 max params (B)** ≈ memory (GB) ÷ 2\n- **Q4 max params (B)** ≈ memory (GB) × 2\n\nExamples: 16GB → 8B fp16 \u002F 32B Q4 — 24GB VRAM → 12B fp16 \u002F 48B Q4 — 8GB → 4B fp16 \u002F 16B Q4\n\n---\n\n## Step 2: Find relevant benchmark datasets\n\nFetch the full list of official HF benchmarks:\n\n```bash\ncurl -s -H \"Authorization: Bearer $(cat ~\u002F.cache\u002Fhuggingface\u002Ftoken)\" \\\n  \"https:\u002F\u002Fhuggingface.co\u002Fapi\u002Fdatasets?filter=benchmark:official&limit=500\" | jq '[.[] | {id, tags, description}]'\n```\n\nRead the returned list and select the datasets most relevant to the user's task — match on dataset id, tags, and description. Use your judgment; don't limit yourself to 2-3. Aim for comprehensive coverage: if 5 benchmarks clearly cover the task, use all 5.\n\n---\n\n## Step 3: Fetch top models from leaderboards\n\nFor each selected benchmark dataset:\n\n```bash\ncurl -s -H \"Authorization: Bearer $(cat ~\u002F.cache\u002Fhuggingface\u002Ftoken)\" \\\n  \"https:\u002F\u002Fhuggingface.co\u002Fapi\u002Fdatasets\u002F\u003Cnamespace>\u002F\u003Crepo>\u002Fleaderboard\" | jq '[.[:15] | .[] | {rank, modelId, value, verified}]'\n```\n\nCollect model IDs and scores across all benchmarks. If a leaderboard returns an error (404, 401, etc.), skip it and note it in the output.\n\n---\n\n## Step 4: Enrich with model metadata\n\nFor the top 10-15 candidate model IDs, get model infos.\n\n```bash\n# REST API\ncurl -s -H \"Authorization: Bearer $(cat ~\u002F.cache\u002Fhuggingface\u002Ftoken)\" \\\n  \"https:\u002F\u002Fhuggingface.co\u002Fapi\u002Fmodels\u002Forg\u002Fmodel1\" | jq '{safetensors, tags, cardData}'\n\n# CLI (hf-cli)\nhf models info org\u002Fmodel1 --json | jq '{safetensors, tags, cardData}'\n```\n\nExtract from each response:\n- **Parameters**: `safetensors.total` → convert to B (e.g., 7_241_748_480 → \"7.2B\")\n- **License**: from model card tags (look for `license:apache-2.0`, `license:mit`, etc.)\n- If `safetensors` is absent, parse size from the model name (look for \"7b\", \"8b\", \"13b\", \"70b\", \"72b\", etc.)\n\n---\n\n## Step 5: Filter and rank\n\n**If a device was specified:**\n1. Remove models exceeding the fp16 parameter budget for the device\n2. Flag models that fit only with Q4 quantization (multiply budget by ~4 for Q4 capacity)\n3. If a highly-ranked model is slightly over budget, keep it with a \"needs Q4\" note — don't silently drop it\n\n**If no device was mentioned:** skip all size filtering — just rank by benchmark score.\n\nThen: rank by benchmark score (descending), keep top 5-8 models.\n\nInclude proprietary models (GPT-4, Claude, Gemini) if they appear on leaderboards, but flag them as \"API only \u002F not self-hostable\". If the user explicitly asked for local\u002Fopen models only, exclude them.\n\n---\n\n## Step 6: Output\n\n### Comparison table\n\n```markdown\n| # | Model | Params | [Benchmark 1] | [Benchmark 2] | License | On device |\n|---|-------|--------|--------------|--------------|---------|-----------|\n| ⭐1 | [org\u002Fname](https:\u002F\u002Fhuggingface.co\u002Forg\u002Fname) | 7B | 85.2% | — | Apache 2.0 | Yes (fp16) |\n| 2 | [org\u002Fname](https:\u002F\u002Fhuggingface.co\u002Forg\u002Fname) | 13B | 83.1% | 71.5% | MIT | Q4 only |\n| 3 | [org\u002Fname](https:\u002F\u002Fhuggingface.co\u002Forg\u002Fname) | 70B | 90.0% | 81.0% | Llama | Too large |\n```\n\n- Link model names to `https:\u002F\u002Fhuggingface.co\u002F\u003Cmodel_id>`\n- Use `—` for benchmarks where the model wasn't evaluated\n- Star the top recommended pick with ⭐\n- \"On device\" values: `Yes (fp16)`, `Q4 only`, `Too large`, `API only`\n\n### Follow-up\n\nAfter presenting the table, ask the user: \"Would you like to run **[top recommended model]**?\"\n\nIf they say yes, ask whether they'd prefer to:\n- **Run locally** — ask about their device if not already known, then give appropriate setup instructions\n- **Run on HF Jobs** — point them to the HF Jobs guide: https:\u002F\u002Fhuggingface.co\u002Fdocs\u002Fhuggingface_hub\u002Fen\u002Fguides\u002Fjobs\n\n---\n\n## Error handling\n\n- **Leaderboard not found**: skip, note \"leaderboard unavailable\" in output\n- **Model missing from hub_repo_details**: fall back to parsing size from model name\n- **No benchmarks found for task**: use the curated fallback table above, or try `hub_repo_search` with `filters=[\"\u003Ctask>\"]` sorted by `trendingScore`\n- **All leaderboards fail**: fall back to `hub_repo_search` for popular models tagged with the task, note that results are by popularity rather than benchmark score\n",{"name":5,"description":7},"main","2a870f189175a48c39f5f7e26a6d93b0be9cd13b",0,"https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills","https:\u002F\u002Ftangyixiao.github.io\u002Ftangyixiao-skills\u002F","https:\u002F\u002Fgithub.com\u002Ftangyixiao","http:\u002F\u002Fwww.sxyz.net\u002F","I am Tang Yixiao, a student in Shaoxing No.1 High School. I am eager to learn on GitHub and contribute my part to this community.","2026-11-11 15:45:59",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add tangyixiao\u002Ftangyixiao-skills --skill huggingface-best",{"tool":40,"command":41},"bunx","bunx skills add tangyixiao\u002Ftangyixiao-skills --skill huggingface-best",{"tool":43,"command":44},"pnpm","pnpm dlx skills add tangyixiao\u002Ftangyixiao-skills --skill huggingface-best","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fhuggingface-best\u002FSKILL.md",true,[48,54],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"INSTALL-SOURCE.json","REFERENCE","参考文档",507,"https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fhuggingface-best\u002FINSTALL-SOURCE.json",{"path":55,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":57,"sourceHtmlUrl":16},"LICENSE","许可证",11357,[59,67,76,84,92,100],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":63,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":20},"01M7D8JK8FYBFNNAJXWD89CFH7","xlsx","Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like \"the xlsx in my downloads\") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fxlsx\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fxlsx\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":71,"licenseFileUrl":72,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":20},"01M7D8JG8ERGGQQAMX0DWCG9GR","writing-shape","Writing, exploit: shape raw material into an article, paragraph by paragraph.","MIT","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fwriting-shape\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fwriting-shape\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":71,"licenseFileUrl":80,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":20},"01M7D8JE672GW3EHSE8EF185M4","writing-fragments","Writing, explore: mine raw fragments, no structure yet.","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fwriting-fragments\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fwriting-fragments\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":71,"licenseFileUrl":88,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":20},"01M7D8JBK572YDFMND8Q6CEYJW","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fwriting-for-agents\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":71,"licenseFileUrl":96,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":20},"01M7D8J5QPWEXX61EGBKYH73R8","writing-clearly-and-concisely","Use when writing prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Applies Strunk's timeless rules for clearer, stronger, more professional writing.","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fwriting-clearly-and-concisely\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fwriting-clearly-and-concisely\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":71,"licenseFileUrl":104,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":20},"01M7D8J36YWC8WZS5DK5AH03CD","writing-beats","Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fwriting-beats\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Ftangyixiao\u002Ftangyixiao-skills\u002Fblob\u002Fmain\u002Fwriting-beats\u002FSKILL.md",[],[]]