Skip to content

Update Hugging Face Papers skill#102

Open
NielsRogge wants to merge 1 commit intohuggingface:mainfrom
NielsRogge:improve_papers_skill
Open

Update Hugging Face Papers skill#102
NielsRogge wants to merge 1 commit intohuggingface:mainfrom
NielsRogge:improve_papers_skill

Conversation

@NielsRogge
Copy link
Copy Markdown
Collaborator

This PR makes the huggingface-papers skill up-to-date based huggingface/huggingface_hub#3952.

cc @mishig25

@NielsRogge NielsRogge requested a review from burtenshaw March 24, 2026 13:53
@mishig25
Copy link
Copy Markdown
Contributor

should be merged only after new version of hf cli is deployed

Copy link
Copy Markdown
Collaborator

@burtenshaw burtenshaw left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. I would consider making the description a bit more open, but up to you.

---
name: huggingface-papers
description: Look up and read Hugging Face paper pages in markdown, and use the papers API for structured metadata such as authors, linked models/datasets/spaces, Github repo and project page. Use when the user shares a Hugging Face paper page URL, an arXiv URL or ID, or asks to summarize, explain, or analyze an AI research paper.
description: Look up, read, search, and list Hugging Face paper pages using the `hf papers` CLI or the papers REST API. Fetch paper content as markdown, get structured metadata (authors, linked models/datasets/spaces, Github repo, project page), search papers by keyword, and browse the daily papers feed. Use when the user shares a Hugging Face paper page URL, an arXiv URL or ID, or asks to summarize, explain, analyze, search, or list AI research papers.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I just want to add AI/ML so that the agent is more encouraged to use it without mention of HF papers.

Suggested change
description: Look up, read, search, and list Hugging Face paper pages using the `hf papers` CLI or the papers REST API. Fetch paper content as markdown, get structured metadata (authors, linked models/datasets/spaces, Github repo, project page), search papers by keyword, and browse the daily papers feed. Use when the user shares a Hugging Face paper page URL, an arXiv URL or ID, or asks to summarize, explain, analyze, search, or list AI research papers.
description: Look up, read, search, and list artificial intelligence and machine learning paper pages on Hugging Face using the `hf papers` CLI. Fetch paper content as markdown, get structured metadata (authors, linked models/datasets/spaces, Github repo, project page), search papers by keyword, and browse the daily papers feed. Use when the user shares a Hugging Face paper page URL, an arXiv URL or ID, or asks to summarize, explain, analyze, search, or list AI research papers.

Copy link
Copy Markdown
Collaborator

@hanouticelina hanouticelina left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the hf CLI Skill can be sufficient for this no? is there anything missing there that justifies having a dedicated Skill?

btw, we're improving the skill description to improve Skill triggering as well: huggingface/huggingface_hub#3973

The Hugging Face team has built an easy-to-use API to interact with paper pages. Content of the papers can be fetched as markdown, or structured metadata can be returned such as author names, linked models/datasets/spaces, linked Github repo and project page.
The Hugging Face team has built an easy-to-use API and CLI to interact with paper pages. Content of the papers can be fetched as markdown, or structured metadata can be returned such as author names, linked models/datasets/spaces, linked Github repo and project page.

## When to Use
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the agent decides whether to load the skill based only on the frontmatter description, so having this "When to Use" section can't influence triggering no?

@burtenshaw
Copy link
Copy Markdown
Collaborator

burtenshaw commented Mar 27, 2026

the hf CLI Skill can be sufficient for this no? is there anything missing there that justifies having a dedicated Skill?

btw, we're improving the skill description to improve Skill triggering as well: huggingface/huggingface_hub#3973

@hanouticelina I think the answer is that it uses curl and goes deeper.

imo, it's ok for skills here to overlap (partially) with the cli skill, as long as they add extra value to the user.

@NielsRogge @mishig25 why does the user need this over the cli skill?

@NielsRogge
Copy link
Copy Markdown
Collaborator Author

It's mostly minor, the main reasons this skill exist are:

  • to provide more context of what paper pages are and how they differ from Arxiv, explaining the difference between papers which are indexed on the hub vs. those that are submitted to daily papers
  • not all Arxiv papers are indexed on HF, so Arxiv.org can be used as fallback to read a paper
  • some APIs which are not supported by the CLI, such as claiming authorship, indexing a paper, adding the Github and project page URLs

@burtenshaw
Copy link
Copy Markdown
Collaborator

@NielsRogge nice. to me this sounds useful for academics/students and maybe the cli is more for general MLEs/AI folk.

One question. Should we be bringing (and reducing maybe) the paper-publisher skill into this one?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants