Paperzilla

Chat with your agent about projects, recommendations, and canonical papers in Paperzilla.

How to use it

  1. Hit Copy the whole skill.
  2. Claude: ⋯ → Download .md, then Customize → Skills → Add → Upload skill.
    ChatGPT: make a Project and paste it into Instructions.
    Neither? Paste it at the top of a new chat — it works for that chat.
  3. Describe your job in plain words. The AI follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit K-Dense-AI/scientific-agent-skills/skills/paperzilla#main ~/.claude/skills/paperzilla

For one project only, change the path to .claude/skills/paperzilla.

Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Show the full text160 lines
paperzilla/SKILL.md160 lines3.7 KBpushed 57d agoRawView on GitHub

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

brew install paperzilla-ai/tap/pz

Windows (Scoop)

scoop 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:

pz update

If detection is ambiguous, override it explicitly:

pz 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

pz login

CLI reference

If the current profile uses pz, these are the core commands.

List projects

pz project list

Show one project

pz project <project-id>

Browse project feed

pz feed <project-id>

Useful flags:

  • --must-read
  • --since YYYY-MM-DD
  • --limit N
  • --json
  • --atom

Examples:

pz 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

pz 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

pz rec <project-paper-id>
pz rec <project-paper-id> --json
pz rec <project-paper-id> --markdown

Leave recommendation feedback

pz 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 --json for machine parsing.
  • pz paper --markdown only returns markdown when it is already prepared.
  • pz rec --markdown can queue markdown generation and prints a friendly retry message while it is still being prepared.
  • --atom returns a personal feed URL for feed readers.

Configuration

export PZ_API_URL="https://paperzilla.ai"

References

1---
2name: paperzilla
3description: Chat with your agent about projects, recommendations, and canonical papers in Paperzilla. Use when users ask for recent project recommendations, canonical paper details, markdown-based summaries, recommendation feedback, feed export, or Atom feed URLs.
4license: MIT
5metadata:
6 version: "1.0"
7 skill-author: Paperzilla Inc
8---
9 
10# Paperzilla
11 
12Use this skill when you want to chat with your agent about projects, recommendations, and canonical papers in Paperzilla.
13 
14## What you can ask
15 
16- "Give me the latest recommendations from project X."
17- "Open recommendation Y and explain why it matters."
18- "Fetch canonical paper Z as markdown and summarize it."
19- "Tell me how this paper is relevant to my research."
20- "Show me the feed for project X."
21- "Leave feedback on a recommendation."
22- "Export this paper, recommendation, or feed as JSON."
23 
24This 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.
25 
26## Access method
27 
28Most current profiles in this repo use the `pz` CLI.
29 
30If the current profile ships extra agent-specific instructions, follow those as well.
31 
32## Install
33 
34### macOS
35```bash
36brew install paperzilla-ai/tap/pz
37```
38 
39### Windows (Scoop)
40```bash
41scoop bucket add paperzilla-ai https://github.com/paperzilla-ai/scoop-bucket
42scoop install pz
43```
44 
45### Linux
46Use the official Linux install guide:
47 
48- https://docs.paperzilla.ai/guides/cli-getting-started
49 
50### Build from source (Go 1.23+)
51See the CLI repository for source builds:
52 
53- https://github.com/paperzilla-ai/pz
54 
55## Update
56 
57Check whether your CLI is up to date and get install-specific upgrade steps:
58 
59```bash
60pz update
61```
62 
63If detection is ambiguous, override it explicitly:
64 
65```bash
66pz update --install-method homebrew
67pz update --install-method scoop
68pz update --install-method release
69pz update --install-method source
70```
71 
72Supported values are `auto`, `homebrew`, `scoop`, `release`, and `source`.
73 
74## Authentication
75 
76```bash
77pz login
78```
79 
80## CLI reference
81 
82If the current profile uses `pz`, these are the core commands.
83 
84### List projects
85```bash
86pz project list
87```
88 
89### Show one project
90```bash
91pz project <project-id>
92```
93 
94### Browse project feed
95```bash
96pz feed <project-id>
97```
98 
99Useful flags:
100- `--must-read`
101- `--since YYYY-MM-DD`
102- `--limit N`
103- `--json`
104- `--atom`
105 
106Examples:
107```bash
108pz feed <project-id> --must-read --since 2026-03-01 --limit 5
109pz feed <project-id> --json
110pz feed <project-id> --atom
111```
112 
113Feed output can include existing recommendation feedback markers:
114 
115- `[↑]` upvote
116- `[↓]` downvote
117- `[★]` star
118 
119### Read a canonical paper
120```bash
121pz paper <paper-id>
122pz paper <paper-id> --json
123pz paper <paper-id> --markdown
124pz paper <paper-id> --project <project-id>
125```
126 
127### Open a recommendation from one of your projects
128```bash
129pz rec <project-paper-id>
130pz rec <project-paper-id> --json
131pz rec <project-paper-id> --markdown
132```
133 
134### Leave recommendation feedback
135```bash
136pz feedback <project-paper-id> upvote
137pz feedback <project-paper-id> star
138pz feedback <project-paper-id> downvote --reason not_relevant
139pz feedback clear <project-paper-id>
140```
141 
142## Output and automation
143 
144- Prefer `--json` for machine parsing.
145- `pz paper --markdown` only returns markdown when it is already prepared.
146- `pz rec --markdown` can queue markdown generation and prints a friendly retry message while it is still being prepared.
147- `--atom` returns a personal feed URL for feed readers.
148 
149## Configuration
150 
151```bash
152export PZ_API_URL="https://paperzilla.ai"
153```
154 
155## References
156 
157- Docs: https://docs.paperzilla.ai/guides/cli
158- Quickstart: https://docs.paperzilla.ai/guides/cli-getting-started
159- Repo: https://github.com/paperzilla-ai/pz
160 

Discussion

Alternatives

Also in Papers & citations