{
  "markdown": "# Paper Tools\n\nPaper Tools is a plugin-style skill bundle for academic paper workflows, focused on computer vision, machine learning, deep learning, and knowledge distillation research.\n\nIt is organized around portable `SKILL.md` skills, with small adapter manifests for different AI CLIs.\n\n## Skills\n\n- `paper-read`: read one local paper and produce a structured research note.\n- `paper-review`: review one local paper with quick or collaborative peer-review workflows.\n\n## Repository Layout\n\n```text\npaper-tools/\n├── .agents/\n│   └── plugins/\n│       └── marketplace.json\n├── plugins/\n│   └── paper-tools/\n│       ├── .codex-plugin/\n│       │   └── plugin.json\n│       └── skills/\n│           ├── paper-read/\n│           └── paper-review/\n├── skills/\n│   ├── paper-read/\n│   └── paper-review/\n├── .codex-plugin/\n│   └── plugin.json\n├── .claude-plugin/\n│   └── plugin.json\n├── .opencode/\n│   ├── INSTALL.md\n│   └── plugins/\n│       └── paper-tools.js\n├── gemini-extension.json\n├── GEMINI.md\n├── AGENTS.md\n└── package.json\n```\n\nThe portable core is `skills/*/SKILL.md`. Tool-specific files are adapters.\n\n## Installation\n\nRepository:\n\n```text\nhttps://github.com/Bryce199805/paper-skills\n```\n\n### Codex\n\nInstall this repository as a Codex plugin marketplace:\n\n```bash\ncodex plugin marketplace add Bryce199805/paper-skills\n```\n\nThen install or enable the `paper-tools` plugin from Codex's plugin UI.\n\nThe marketplace index is:\n\n```text\n.agents/plugins/marketplace.json\n```\n\nThe Codex plugin manifest is:\n\n```text\nplugins/paper-tools/.codex-plugin/plugin.json\n```\n\nIt declares:\n\n```json\n\"skills\": \"./skills/\"\n```\n\nAfter installation, Codex should expose:\n\n```text\npaper-read\npaper-review\n```\n\nFor local development without the marketplace flow, link the skills directly:\n\n```bash\nmkdir -p ~/.codex/skills\nln -s /absolute/path/to/paper-skills/skills/paper-read ~/.codex/skills/paper-read\nln -s /absolute/path/to/paper-skills/skills/paper-review ~/.codex/skills/paper-review\n```\n\n### Claude Code\n\nInstall as a Claude plugin from the repository:\n\n```text\nhttps://github.com/Bryce199805/paper-skills\n```\n\nThe Claude manifest is:\n\n```text\n.claude-plugin/plugin.json\n```\n\nThe skills are in:\n\n```text\nskills/\n```\n\n### Gemini CLI\n\nInstall as a Gemini extension:\n\n```bash\ngemini extensions install https://github.com/Bryce199805/paper-skills\n```\n\nGemini uses:\n\n```text\ngemini-extension.json\nGEMINI.md\n```\n\n### OpenCode\n\nAdd Paper Tools to the `plugin` array in `opencode.json`:\n\n```json\n{\n  \"plugin\": [\"paper-tools@git+https://github.com/Bryce199805/paper-skills.git\"]\n}\n```\n\nFor local development:\n\n```json\n{\n  \"plugin\": [\"paper-tools@file:///absolute/path/to/paper-tools\"]\n}\n```\n\nRestart OpenCode after changing the config.\n\nThe OpenCode plugin entry is:\n\n```text\n.opencode/plugins/paper-tools.js\n```\n\nIt registers this repository's `skills/` directory automatically. No copied skill folders or symlinks are required.\n\n### Generic Agents\n\nAgents that understand `AGENTS.md` can use:\n\n```text\nAGENTS.md\n```\n\nAgents that directly load `SKILL.md` directories can point to:\n\n```text\nskills/paper-read\nskills/paper-review\n```\n\n## Local Parsing Dependencies\n\nThe paper skills prioritize local file parsing.\n\nRequired lightweight tools:\n\n- `python3`\n- `pdftotext`\n- `pdfinfo`\n- `detex` for `.tex` files\n\nOptional enhancement:\n\n- `PyMuPDF` (`pymupdf`, imported as `fitz`) for coordinate-aware PDF extraction.\n\nPDF parsing is designed for two-column CV/ML papers, but extraction quality still depends on the source PDF.\n\n## Development Notes\n\nWhen adding a new paper-related skill:\n\n1. Add it under `skills/<skill-name>/`.\n2. Include a valid `SKILL.md`.\n3. Keep CLI-specific metadata in adapter files, not in the core skill unless the target CLI requires it.\n4. Update this README's skill list.\n",
  "bytes": 3776,
  "sha": "4aae0bff22757d938dadddf614d1ee13e6f65423a825dcc9c17b6a41136c6fc4",
  "repo_slug": "bryce199805/paper-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_bryce199805_paper_skills_ac88d65b/readme"
}