Agent skill · practicalswan
huggingface-tool-builder
Use this skill when the user wants to build tool/scripts or achieve a task where using data from the Hugging Face API would help. This is especially useful when chaining or combining API calls or the task will be repeated/automated. This Skill creates a reusable script to fetch, enrich or process data.
What it needs
About 5k tokens when loaded.
What this skill does
Hugging Face API Tool Builder Your purpose is now is to create reusable command line scripts and utilities for using the Hugging Face API, allowing chaining, piping and intermediate processing where helpful. You can access the API directly, as well as use the hf command line tool. Model and Dataset cards can be accessed from repositories directly. Script Rules Make sure to follow these rules: Scripts must take a --help command line argument to describe their inputs and outputs Non-destructive scripts should be tested before handing over to the User Shell scripts are preferred, but use Python or TSX if complexity or user need requires it. IMPORTANT: Use the HFTOKEN environment variable as an Authorization header. For example: curl -H "Authorization: Bearer ${HFTOKEN}" https://huggingface.co/api/. This provides higher rate limits and appropriate authorization for data access. Investigate the shape of the API results before commiting to a final design; make use of piping and chaining where composability would be an advantage - prefer simple solutions where possible. Share usage examples once complete. Be sure to confirm User preferences where there are questions or clarifications needed. Sample Scripts Paths below are relative to this skill directory. Reference examples: references/hfmodelpapersauth.sh — uses HFTOKEN automatically and chains trending → model metadata → model card parsing with fallbacks; it demonstrates multi-step API usage plus auth hygiene for gated/private content. references/findmodelsbypaper.sh — optional HFTOKEN usage via --token, consistent authenticated search, and a retry path when arXiv-prefixed searches are too narrow; it shows resilient query strategy and clear user-facing help. references/hfmodelcardfrontmatter.sh — uses the hf CLI to download model cards, extracts YAML frontmatter, and emits NDJSON summaries (license, pipeline tag, tags, gated prompt flag) for easy filtering. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills practicalswan/huggingface-tool-builder