Paperzilla
Use this skill when you want to chat with your agent about projects, recommendations, and canonical papers in Paperzilla.
What you can ask
- "Give me the latest recommendations from project X."
- "Open recommendation Y and explain why it matters."
- "Fetch canonical paper Z as markdown and summarize it."
- "Tell me how this paper is relevant to my research."
- "Show me the feed for project X."
- "Leave feedback on a recommendation."
- "Export this paper, recommendation, or feed as JSON."
This is the core Paperzilla skill. It gives your agent direct access to Paperzilla data, but it does not impose a workflow or external delivery integration.
Access method
Most current profiles in this repo use the pz CLI.
If the current profile ships extra agent-specific instructions, follow those as well.
Install
macOS
bashbrew install paperzilla-ai/tap/pz
Windows (Scoop)
bashscoop bucket add paperzilla-ai https://github.com/paperzilla-ai/scoop-bucket scoop install pz
Linux
Use the official Linux install guide:
Build from source (Go 1.23+)
See the CLI repository for source builds:
Update
Check whether your CLI is up to date and get install-specific upgrade steps:
bashpz update
If detection is ambiguous, override it explicitly:
bashpz update --install-method homebrew pz update --install-method scoop pz update --install-method release pz update --install-method source
Supported values are auto, homebrew, scoop, release, and source.
Authentication
bashpz login
CLI reference
If the current profile uses pz, these are the core commands.
List projects
bashpz project list
Show one project
bashpz project <project-id>
Browse project feed
bashpz feed <project-id>
Useful flags:
--must-read--since YYYY-MM-DD--limit N--json--atom
Examples:
bashpz feed <project-id> --must-read --since 2026-03-01 --limit 5 pz feed <project-id> --json pz feed <project-id> --atom
Feed output can include existing recommendation feedback markers:
[↑]upvote[↓]downvote[★]star
Read a canonical paper
bashpz paper <paper-id> pz paper <paper-id> --json pz paper <paper-id> --markdown pz paper <paper-id> --project <project-id>
Open a recommendation from one of your projects
bashpz rec <project-paper-id> pz rec <project-paper-id> --json pz rec <project-paper-id> --markdown
Leave recommendation feedback
bashpz feedback <project-paper-id> upvote pz feedback <project-paper-id> star pz feedback <project-paper-id> downvote --reason not_relevant pz feedback clear <project-paper-id>
Output and automation
- Prefer
--jsonfor machine parsing. pz paper --markdownonly returns markdown when it is already prepared.pz rec --markdowncan queue markdown generation and prints a friendly retry message while it is still being prepared.--atomreturns a personal feed URL for feed readers.
Configuration
bashexport PZ_API_URL="https://paperzilla.ai"


