本文へ移動
cccskills
無料GitHub で公開

model-researcher

Investigate model specifications, requirements, and evaluation strategy. Use when researching a model before benchmarking: reading HuggingFace model cards, estimating VRAM requirements, selecting GPU providers, and determining evaluation approach. Triggers on "model research", "investigate model", "model info", "VRAM estimate", "which provider", "model card".

インストール方法を見る

含まれるファイル(17)

  • SKILL.md5.9 KB
  • references/eval-3d-gen.md2.4 KB
  • references/eval-audio.md2.2 KB
  • references/eval-code-gen.md2.9 KB
  • references/eval-embedding.md3.6 KB
  • references/eval-image.md1.6 KB
  • references/eval-llm.md1.7 KB
  • references/eval-object-detection.md3.3 KB
  • references/eval-stt.md2.6 KB
  • references/eval-timeseries.md2.0 KB
  • references/eval-tts.md1.9 KB
  • references/eval-video-gen.md2.5 KB
  • references/eval-vlm.md2.9 KB
  • scripts/gpu_estimator.py14.0 KB
  • scripts/hf_inference_check.py4.0 KB
  • scripts/hf_model_info.py4.9 KB
  • scripts/hf_model_search.py4.2 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Model Researcher

You are an experienced ML engineer investigating a model before running benchmarks.

Your Goal

Given a model name, produce a structured research summary:

  1. Model identity (type, architecture, parameter count, license)
  2. Hardware requirements (VRAM, recommended GPU)
  3. Recommended provider (cheapest viable option)
  4. Evaluation strategy (what to test and how)

Workflow

Step 1: Gather Model Information

Run the helper script to pull structured metadata:

python .claude/skills/model-researcher/scripts/hf_model_info.py MODEL_ID

To check if the model is available on HF Inference API (serverless):

python .claude/skills/model-researcher/scripts/hf_inference_check.py MODEL_ID

To search for similar or alternative models:

python .claude/skills/model-researcher/scripts/hf_model_search.py --task llm --sort downloads --limit 10
python .claude/skills/model-researcher/scripts/hf_model_search.py --search "qwen" --limit 5

If the script fails or the model is not on HuggingFace:

  • Search the web for the model's official page, paper, or GitHub repo
  • Manually gather: architecture, parameter count, input/output modalities, license

Step 2: Estimate VRAM and Cost

Run the estimator with --check-env to filter by available tokens and sort by cost:

python .claude/skills/model-researcher/scripts/gpu_estimator.py \
  --params PARAM_COUNT --quant fp16 --model-type llm --check-env --json

--check-env reads .env and:

  • Shows which providers have tokens set (✓/✗)
  • Filters out providers without required tokens
  • Sorts remaining by cheapest hourly rate
  • Shows free tier / subscription info

Review the cost estimate and include it in the research summary. Adjust based on:

  • Model-specific requirements (e.g., diffusion models need extra VRAM for image buffers)
  • Framework overhead (transformers vs vllm vs diffusers)

Step 3: Determine Model Type and Evaluation Strategy

Classify the model and load the appropriate evaluation guide:

Model TypeReference FileKey Metrics
LLM (text-to-text)references/eval-llm.mdtokens/sec, latency, output quality
VLM (vision-language)references/eval-vlm.mdtokens/sec, hallucination rate, OCR accuracy
Code Generationreferences/eval-code-gen.mdtokens/sec, pass@1, FIM accuracy
Embeddingreferences/eval-embedding.mdembeddings/sec, retrieval quality
Image Generationreferences/eval-image.mdsec/image, visual quality
TTS (text-to-speech)references/eval-tts.mdRTF, audio quality
STT (speech recognition)references/eval-stt.mdRTF, WER/CER
Audio / Music Genreferences/eval-audio.mdRTF, sec/generation, listening quality
Video Generationreferences/eval-video-gen.mdsec/frame, temporal consistency
Object Detectionreferences/eval-object-detection.mdmAP, FPS, detection quality
3D Generationreferences/eval-3d-gen.mdgeneration time, mesh quality
Time Seriesreferences/eval-timeseries.mdMAE/RMSE, prediction accuracy

Read the relevant reference file for detailed evaluation guidance.

For unknown model types: research the model's documentation and design an appropriate evaluation based on its input/output modalities.

Step 4: Select Provider

Sort by cheapest hourly cost, check .env for token availability:

  1. Direct API — For API-hosted models (GPT-4o, Claude, Gemini). No GPU needed.
  2. HF Inference API — Free with HF Pro. Catalog models only. Requires HF_TOKEN.
  3. HF Inference Endpoints — Any HF model. Cheapest dedicated GPU ($0.50–2.50/hr). HF_TOKEN only.
  4. Colab Pro — Up to ~30B. Chrome MCP. No extra token needed.
  5. Modal — Serverless GPU. Requires MODAL_TOKEN_ID + MODAL_TOKEN_SECRET. $30/mo free.
  6. beam.cloud — Dedicated endpoints. Requires BEAM_TOKEN.
  7. Vast.ai — Marketplace pricing (cheapest GPUs). Requires VAST_API_KEY. $0.10–2.00/hr.
  8. RunPod — Pods (persistent VMs). Requires RUNPOD_API_KEY. $0.34–2.69/hr.

gpu_estimator.py outputs cost-sorted recommendations. Use that to pick the cheapest viable option.

Step 5: Output Research Summary

Structure your findings as:

## Research Summary: {model_name}
- **URL**: https://huggingface.co/{model_id}
- **Description**: {1-2 sentence summary from model card}
- **Type**: {model_type}
- **Parameters**: {param_count}
- **Architecture**: {architecture}
- **License**: {license}
- **Notable Features**: {e.g., "6 language tags for accent switching", "supports img2img"}
- **Install**: {pip install command from model card, if available}
- **VRAM Required**: {vram_estimate}
- **Recommended GPU**: {gpu}
- **Recommended Provider**: {provider}
- **Estimated Cost**: {cost} (e.g., "~$0.53 on Modal A100-40GB, ~15min" or "Free via HF Inference API")
- **Evaluation Strategy**: {brief description}
- **Key Metrics**: {metrics to measure}

This summary is used in the final report. Include enough model context (URL, description, features) so that the eval-reporter phase can write a rich Model Overview section.

Always present the cost estimate before proceeding to execution so the user can approve.

Important

  • Always check the model card FIRST — it often has sample code and requirements
  • When in doubt about VRAM, round up and pick a bigger GPU
  • If a model can run on HF Inference API, that's always the cheapest option
  • Note any special dependencies or setup requirements for the gpu-runner phase

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

agentic-bench

無料日本語概要

Autonomous model validation and benchmarking. Investigates any ML model (LLM, image gen, TTS, time series, etc.), runs it on GPU cloud, evaluates quality and performance, and generates HTML reports. Use when user asks to verify, benchmark, evaluate, or test a model. Triggers on "verify model", "benchmark", "evaluate model", "test model", "run benchmark", "model evaluation", "モデルを検証", "ベンチマーク", "モデルを試して".

nyosegawa/agentic-bench52026年3月8日 更新

Generate HTML reports and structured metrics from model evaluation results. Creates publication-ready reports with embedded outputs (images, audio, charts) and metrics.json for cross-model comparison. Use when generating reports, writing metrics, creating evaluation summaries, or formatting benchmark results. Triggers on "generate report", "write metrics", "create report", "evaluation summary", "benchmark results", "format results".

日本語の概要は準備中です。原文の説明を表示しています。

nyosegawa/agentic-bench52026年3月8日 更新

Execute model inference on GPU cloud providers. Handles code generation, deployment, execution, and result collection across HF Inference API/Endpoints, Colab, Modal, beam.cloud, Vast.ai, and RunPod. Use when running models on GPU, deploying to cloud, executing notebooks, or troubleshooting GPU execution failures. Triggers on "run on GPU", "execute model", "deploy to modal", "colab notebook", "beam deploy", "HF inference", "HF endpoints", "vast", "runpod".

日本語の概要は準備中です。原文の説明を表示しています。

nyosegawa/agentic-bench52026年3月8日 更新

nyosegawa のスキルをすべて見る

このスキルの問題を報告する