Name: collection-organizer
Author: yiyabo

Imported from yiyabo/zotero-reading-assistant (src/features/collection-organizer/AGENTS.md). Install upstream with npx skills add yiyabo/zotero-reading-assistant --skill collection-organizer. Copyright stays with the author.

Collection Organizer Feature

OVERVIEW

AI-assisted collection management. Analyzes papers in the library and proposes collection reorganizations. All changes require user confirmation — nothing is auto-applied.

STRUCTURE

collection-organizer/
├── CollectionManager.ts    # Read/write wrapper around Zotero Collections API
├── CollectionAnalyzer.ts   # LLM-based analysis of paper→collection fit
└── OrganizerPage.ts        # UI for reviewing and applying proposals

WHERE TO LOOK

Task	Location	Notes
Collection tree reading	`CollectionManager.ts:getTopLevelCollections`	Reads Zotero collections hierarchy
Paper briefs	`CollectionManager.ts:PaperBrief`	Structured paper summary for LLM analysis
Proposal generation	`CollectionAnalyzer.ts`	Sends paper briefs + collection tree to LLM
User review UI	`OrganizerPage.ts`	Shows proposals, lets user accept/reject each

CONVENTIONS

Proposal-only: The analyzer generates proposals. The user must confirm each one. Never auto-apply collection changes.
CollectionInfo type: { id, key, name, parentID, childIDs, itemKeys } — the basic unit for all collection operations.

Install collection-organizer and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "yiyabo-zotero-reading-assistant-collection-organizer", "kind": "skill", "name": "collection-organizer", "description": "AI-assisted collection management. Analyzes papers in the library and proposes collection reorganizations. All changes require user confirmation — nothing is auto-applied.", "publisher": "yiyabo", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "AI-assisted collection management. Analyzes papers in the library and proposes collection reorganizations. All changes require user confirmation — nothing is auto-applied." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/yiyabo/zotero-reading-assistant", "path": "src/features/collection-organizer/AGENTS.md", "ref": "d152fac70421a899872dd6edf68165d5123e9150", "url": "https://github.com/yiyabo/zotero-reading-assistant/blob/d152fac70421a899872dd6edf68165d5123e9150/src/features/collection-organizer/AGENTS.md", "key": "yiyabo/zotero-reading-assistant/src/features/collection-organizer/AGENTS.md" } }, "instructions": "# Collection Organizer Feature\n\n## OVERVIEW\n\nAI-assisted collection management. Analyzes papers in the library and proposes collection reorganizations. All changes require user confirmation — nothing is auto-applied.\n\n## STRUCTURE\n\n```\ncollection-organizer/\n├── CollectionManager.ts # Read/write wrapper around Zotero Collections API\n├── CollectionAnalyzer.ts # LLM-based analysis of paper→collection fit\n└── OrganizerPage.ts # UI for reviewing and applying proposals\n```\n\n## WHERE TO LOOK\n\n| Task | Location | Notes |\n|------|----------|-------|\n| Collection tree reading | `CollectionMa", "cost": { "context_tokens": 304 } }

collection-organizer

About