paperhub-import-paper

name	paperhub-import-paper
description	Import a paper into PaperHub from BibTeX, title, or URL

PaperHub Import Paper

Use this skill when the user wants to bring a paper into PaperHub from a BibTeX entry, title, DOI-like reference, or URL.

What this skill does

• Resolves metadata through the PaperHub import flow
• Creates or updates the canonical paper under library/papers/<paper-id>/
• Adds the paper to a project when requested
• Marks PDF availability and can optionally hydrate the PDF

Inputs it handles

• bibtex
• title
• url
• target project
• tags
• whether to download the PDF now

Workflow

1. Ensure the target workspace exists and is initialized.
2. Prefer the most explicit source the user gave:

• BibTeX first
• URL second
• Title third

3. Run:

paperhub import-paper --workspace <workspace-path> [--bibtex ... | --url ... | --title ...] [--project <project>] [--tag <tag>] [--download-pdf]

4. Return:

• paper_id
• canonical path
• tags
• projects
• PDF availability

Operational rules

• A paper always lives under one canonical library/papers/<paper-id>/ home.
• If the paper already exists, update the existing record instead of creating duplicates.
• If the user did not explicitly ask for a local PDF, prefer metadata-first import and leave the PDF dehydrated.