Agent skill

Add Model Descriptions

by ruvnet in ruvnet/ruflo

Finds models on the Hugging Face router that lack descriptions in chat-ui's prod.yaml and dev.yaml, researches each one and adds short descriptions.

MITAuto-check passedAI & LLM Engineering

Install Add Model Descriptions

skills CLI
$ npx skills add ruvnet/ruflo --skill add-model-descriptions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ruvnet/ruflo add-model-descriptions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ruflo/src/ruvocal/.claude/skills/add-model-descriptions .claude/skills/add-model-descriptions && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
add-model-descriptions
GitHub stars
74k
Used in
1 other repo
Token cost
~600 tokens
SKILL.md length
214 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

Finds models on the Hugging Face router that lack descriptions in chat-ui's prod.yaml and dev.yaml, researches each one and adds short descriptions.

  • Works in 7 steps: Fetch models from router → Read current configuration → Identify missing models → …
  • New models have appeared on the Hugging Face router and the chat-ui config lacks them
  • SKILL.md covers Workflow and Notes
  • Calls git; reaches router.huggingface.co

What it does

The workflow fetches the model list from router.huggingface.co/v1/models, reads chart/env/prod.yaml and pulls the model IDs out of its MODELS JSON array. Any ID present on the router but absent from the file counts as missing. Each missing model is then researched on the web for its architecture, key capabilities and target use cases.

Descriptions follow the existing house style: eight to twelve words, sentence fragments, no articles unless needed, centered on architecture, specialization and key capability. New entries go at the top of the MODELS array in both prod.yaml and dev.yaml as id and description pairs, and the change is committed with a message that states how many models were added. Notes cover FP8 variants, vision-language models, agent models and regional language focus.

When your agent uses it

  • New models have appeared on the Hugging Face router and the chat-ui config lacks them
  • Syncing prod.yaml and dev.yaml with the router's current model list
  • Writing short, consistent one-line descriptions for model entries

Example prompts

  • “Add descriptions for any new models on the router to prod.yaml and dev.yaml.”
  • “Sync models from the router and commit the updated chat-ui configs.”
  • “Which router models are missing from chart/env/prod.yaml? Describe them and add them.”

Requirements

  • A chat-ui checkout with chart/env/prod.yaml and dev.yaml
  • Network access and web search

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Fetch models from router
  2. Read current configuration
  3. Identify missing models
  4. Research each missing model
  5. Write descriptions
  6. Update both files
  7. Commit changes

What it can do on your machine

Read from SKILL.md and the folder at commit 58e0ae7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • router.huggingface.co

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Add Model Descriptions loads about 600 tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 214 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~600

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ruvnet/ruflo at commit 58e0ae7, republished under its MIT licence (© ruvnet). 214 words, ~600 tokens.

Download SKILL.mdSave it as .claude/skills/add-model-descriptions/SKILL.md (or your agent's skills folder).
name
add-model-descriptions
description
Add descriptions for new models from the HuggingFace router to chat-ui configuration. Use when new models are released on the router and need descriptions added to prod.yaml and dev.yaml. Triggers on requests like "add new model descriptions", "update models from router", "sync models", or when explicitly invoking /add-model-descriptions.

Add Model Descriptions

Add descriptions for new models available in the HuggingFace router to chat-ui's prod.yaml and dev.yaml.

Workflow

  1. Fetch models from router

    WebFetch https://router.huggingface.co/v1/models

    Extract all model IDs from the response.

  2. Read current configuration

    • Read chart/env/prod.yaml
    • Extract model IDs from the MODELS JSON array in envVars
  3. Identify missing models Compare router models with prod.yaml. Missing = in router but not in prod.yaml.

  4. Research each missing model For each missing model, search the web for its specifications:

    • Model architecture (dense, MoE, parameters)
    • Key capabilities (coding, reasoning, vision, multilingual, etc.)
    • Target use cases
  5. Write descriptions Match existing style:

    • 8-12 words
    • Sentence fragments (no period needed)
    • No articles ("a", "the") unless necessary
    • Focus on: architecture, specialization, key capability

    Examples:

    • "Flagship GLM MoE for coding, reasoning, and agentic tool use."
    • "MoE agent model with multilingual coding and fast outputs."
    • "Vision-language Qwen for documents, GUI agents, and visual reasoning."
    • "Mobile agent for multilingual Android device automation."
  6. Update both files Add new models at the TOP of the MODELS array in:

    • chart/env/prod.yaml
    • chart/env/dev.yaml

    Format:

    json
    { "id": "org/model-name", "description": "Description here." }
  7. Commit changes

    git add chart/env/prod.yaml chart/env/dev.yaml
    git commit -m "feat: add descriptions for N new models from router"

Notes

  • FP8 variants: describe as "FP8 [base model] for efficient inference with [key capability]"
  • Vision models: mention "vision-language" and key visual tasks
  • Agent models: mention "agent" and automation capabilities
  • Regional models: mention language focus (e.g., "European multilingual", "Southeast Asian")

© ruvnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in ruflo/src/ruvocal/.claude/skills/add-model-descriptions of ruvnet/ruflo.

Open the folder on GitHubat commit 58e0ae7

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in ruvnet/ruflo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Add Model Descriptions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Add Model Descriptions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Model Descriptions this skillruvnet/ruflo74k1 repos~600Automated safety check: PassMIT
SageMaker Serving Image Selectionhuggingface/skills11k1 repos~4.6kAutomated safety check: PassApache-2.0
Hugging Face Local Model Evalshuggingface/skills11k2 repos~1.6kAutomated safety check: PassApache-2.0
Esmfold2JimLiu/science-skills2274 repos~2.5kAutomated safety check: PassApache-2.0
Qwen Mtp GgufR6410418/Jackrong-llm-finetuning-guide1.7k—~1.7kAutomated safety check: PassMIT
Dataset Transformationawslabs/agent-plugins9151 repos~3.5kAutomated safety check: PassApache-2.0

Similar skills

  • Official

    Chooses the right serving container and current image URI for deploying a Hugging Face model to a SageMaker endpoint, preferring Hugging Face images over generic ones.

    11k GitHub starsUsed in 1 repo~4.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Official

    Runs evaluations of Hugging Face Hub models on local hardware with inspect-ai or lighteval, and helps choose between vLLM, Transformers and accelerate backends.

    11k GitHub starsUsed in 2 repos~1.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Esmfold2

    JimLiu/science-skills

    Biohub ESMFold2 / ESMFold2-Fast all-atom co-folding (Candido et al.

    227 GitHub starsUsed in 4 repos~2.5k tokens
    AI & LLM EngineeringAuto-check passed
  • Qwen Mtp Gguf

    R6410418/Jackrong-llm-finetuning-guide

    Complete agent-ready workflow for Qwen-family MTP or nextn GGUF conversion and release.

    1.7k GitHub stars~1.7k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Dataset Transformation

    awslabs/agent-plugins

    Official

    Generates code that transforms datasets between ML schemas for model training or evaluation.

    915 GitHub starsUsed in 1 repo~3.5k tokens
    AI & LLM EngineeringAuto-check passed
  • Hugging Face Tokenizers

    Orchestra-Research/AI-Research-SKILLs

    Shows how to load, train and use fast Hugging Face tokenizers, with BPE, WordPiece and Unigram models, padding, truncation and alignment tracking.

    13k GitHub starsUsed in 6 repos~3.4k tokens
    AI & LLM EngineeringAuto-check passed

More from ruvnet/ruflo

All 264 skills in this repo
  • Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 2 repos~830 tokens
    Auto-check passed
  • Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed
  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed
  • Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Works with

Questions about Add Model Descriptions

What does Add Model Descriptions do?

Finds models on the Hugging Face router that lack descriptions in chat-ui's prod.yaml and dev.yaml, researches each one and adds short descriptions. yaml and pulls the model IDs out of its MODELS JSON array. Any ID present on the router but absent from the file counts as missing.

When should I use Add Model Descriptions?

Add Model Descriptions fits situations like: new models have appeared on the Hugging Face router and the chat-ui config lacks them; syncing prod.yaml and dev.yaml with the router's current model list; writing short, consistent one-line descriptions for model entries.

How do I install Add Model Descriptions in Claude Code?

Run `npx skills add ruvnet/ruflo --skill add-model-descriptions -a claude-code`. Or copy the skill folder (ruflo/src/ruvocal/.claude/skills/add-model-descriptions in ruvnet/ruflo) into .claude/skills/add-model-descriptions in your project. Claude Code loads it when a task matches its description.

How do I install Add Model Descriptions in Codex?

Run `npx skills add ruvnet/ruflo --skill add-model-descriptions -a codex`. Or copy the skill folder (ruflo/src/ruvocal/.claude/skills/add-model-descriptions in ruvnet/ruflo) into .agents/skills/add-model-descriptions in your project. Codex loads it when a task matches its description.

Can I use Add Model Descriptions in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ruvnet/ruflo --skill add-model-descriptions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-model-descriptions, .gemini/skills/add-model-descriptions, .github/skills/add-model-descriptions and .opencode/skills/add-model-descriptions in your project.

What does Add Model Descriptions need to run?

Going by SKILL.md and its folder, Add Model Descriptions needs the command-line tools its instructions call (git). Our summary lists: A chat-ui checkout with chart/env/prod.yaml and dev.yaml; Network access and web search.

Does Add Model Descriptions access the network?

SKILL.md names 1 domain. In commands or code: router.huggingface.co; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Add Model Descriptions safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Add Model Descriptions use?

Add Model Descriptions is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add Model Descriptions use?

About 600 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Add Model Descriptions?

Skills that share tags, products or a category with Add Model Descriptions: SageMaker Serving Image Selection (huggingface/skills, 11k stars), Hugging Face Local Model Evals (huggingface/skills, 11k stars), Esmfold2 (JimLiu/science-skills, 227 stars) and Qwen Mtp Gguf (R6410418/Jackrong-llm-finetuning-guide, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Model Descriptions?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,159 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 9, 2026.

Source: ruvnet/ruflo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.