Skip to content
Back to search

co-researcher-marketplace

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/poemswe-co-researcher/badge.svg)](/listings/poemswe-co-researcher)

HTML

<a href="/listings/poemswe-co-researcher"><img src="/api/listings/poemswe-co-researcher/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

| Platform | Install | |---|---| | Claude Code | `/plugin marketplace add poemswe/co-researcher` then `/plugin install co-researcher` | | Gemini CLI | `gemini extension install https://github.com/poemswe/co-researcher` | | Codex | Tell Codex: `Fetch and follow instructions from https://raw.githubusercontent.com/poemswe/co-researcher/main/.codex/INSTALL.md` | | OpenCode | Tell OpenCode: `Fetch and follow instructions from https://raw.githubusercontent.com/poemswe/co-researcher/main/.opencode/INSTALL.md` | | Other agents ([skills.sh](https://skills.sh/poemswe/co-researcher)) | `npx skills add poemswe/co-researcher` (skills only, without the commands or the session-start hook) |

Manual setup for each platform is in [.codex/INSTALL.md](.codex/INSTALL.md) and [.opencode/INSTALL.md](.opencode/INSTALL.md). From a local clone, Gemini users can run `gemini extension link .`, and Claude CLI users `claude plugin marketplace add poemswe/co-researcher && claude plugin install co-researcher`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 39 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "co-researcher-marketplace",
  3. "owner": {
  4. "name": "poemswe",
  5. "email": "poepoemyintswe@gmail.com"
  6. },
  7. "plugins": [
  8. {
  9. "name": "co-researcher",
  10. "source": "./",
  11. "description": "Academic research plugin for Claude Code: literature reviews, systematic reviews, peer review and citation checking, with every citation verified against OpenAlex, arXiv and Europe PMC",
  12. "version": "2.12.0",
  13. "author": {
  14. "name": "poemswe"
  15. },
  16. "license": "MIT",
  17. "keywords": [
  18. "academic-research",
  19. "research",
  20. "literature-review",
  21. "systematic-review",
  22. "citation-verification",
  23. "peer-review",
  24. "claude-code-plugin",
  25. "research-assistant",
  26. "critical-analysis",
  27. "hypothesis",
  28. "investigation",
  29. "evaluation",
  30. "testing",
  31. "agents",
  32. "skills",
  33. "commands"
  34. ],
  35. "homepage": "https://github.com/poemswe/co-researcher",
  36. "repository": "https://github.com/poemswe/co-researcher"
  37. }
  38. ]
  39. }
README.md · README · 146 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Co-Researcher: Academic Research Plugin for Claude Code
  2. ![Version](https://img.shields.io/badge/version-2.12.0-1e3a8a) ![License: MIT](https://img.shields.io/badge/license-MIT-065f46)
  3. Co-Researcher is an academic research plugin for **Claude Code**, **Gemini CLI**, **OpenAI Codex** and **OpenCode**. It runs literature reviews, systematic reviews, peer review and citation checks inside the AI assistant you already use.
  4. Searches run against real scholarly databases (OpenAlex, arXiv, Europe PMC), and every bibliography passes a verification gate that catches fabricated, mismatched, and retracted citations before output.
  5. ## Installation
  6. | Platform | Install |
  7. |---|---|
  8. | Claude Code | `/plugin marketplace add poemswe/co-researcher` then `/plugin install co-researcher` |
  9. | Gemini CLI | `gemini extension install https://github.com/poemswe/co-researcher` |
  10. | Codex | Tell Codex: `Fetch and follow instructions from https://raw.githubusercontent.com/poemswe/co-researcher/main/.codex/INSTALL.md` |
  11. | OpenCode | Tell OpenCode: `Fetch and follow instructions from https://raw.githubusercontent.com/poemswe/co-researcher/main/.opencode/INSTALL.md` |
  12. | Other agents ([skills.sh](https://skills.sh/poemswe/co-researcher)) | `npx skills add poemswe/co-researcher` (skills only, without the commands or the session-start hook) |
  13. Manual setup for each platform is in [.codex/INSTALL.md](.codex/INSTALL.md) and [.opencode/INSTALL.md](.opencode/INSTALL.md). From a local clone, Gemini users can run `gemini extension link .`, and Claude CLI users `claude plugin marketplace add poemswe/co-researcher && claude plugin install co-researcher`.
  14. ## Commands
  15. | Task | Claude / Gemini | Codex |
  16. |---|---|---|
  17. | Research project | `/research` | `$research` |
  18. | Critical analysis | `/analyze` | `$analyze` |
  19. | Peer review | `/review` | `$review` |
  20. Everything else runs when you describe the task in plain language, and the matching skill starts on its own.
  21. `/research "remote work and productivity"` drafts a plan and waits for your approval before running it. Add `--auto` to skip the approval, `--plan-only` to stop at the plan, or `--template=quick|rigorous|comprehensive` for a preset depth.
  22. ## Skills
  23. Each skill follows the **Systemic Honesty** principles, which a session-start hook loads automatically.
  24. - **literature-review**: database search, screening and synthesis, with an evidence check before delivery
  25. - **systematic-review**: PRISMA-standard systematic reviews
  26. - **research-synthesis**: narrative synthesis with stated uncertainty
  27. - **multi-source-investigation**: cross-checking claims across sources
  28. - **critical-analysis**: logic checking and fallacy detection
  29. - **peer-review**: manuscript critique and methodological review
  30. - **research-methodology**: design selection and validation, including cross-domain and first-principles reframing
  31. - **hypothesis-testing**: hypotheses, variables, falsification criteria, manipulation checks and scorer checks
  32. - **quantitative-analysis**: test selection, power and effect sizes
  33. - **qualitative-research**: coding and thematic analysis
  34. - **ethics-review**: IRB compliance and privacy risk
  35. - **grant-writing**: proposals and specific aims
  36. - **academic-writing**: removing AI-isms from research prose
  37. - **research-manager**: task planning and resumable project state
  38. - **using-co-researcher**: orientation to the suite
  39. ## Literature Reviews With Evidence Checks
  40. Ask your agent for a literature review ("review the evidence on remote work and
  41. productivity"), or invoke the `literature-review` skill. The agent searches
  42. OpenAlex, arXiv and Europe PMC, screens what it finds, reads the full texts it
  43. can retrieve through legal open-access routes, and writes everything into a
  44. workspace under your current directory.
  45. | File in `review/{slug}/` | Holds |
  46. |---|---|
  47. | `protocol.md` | the question, inclusion criteria and query log |
  48. | `corpus.json` | every candidate paper and its screening decision |
  49. | `papers/{key}/fulltext.md` | the retrieved text of each included paper |
  50. | `synthesis.md` | the review itself |
  51. | `claims.json` | one entry per cited sentence, with the verbatim quote behind it |
  52. | `refs.json` | the bibliography, checked against OpenAlex, Europe PMC and Crossref |
  53. Before delivering, the agent runs `validate_review.py`, which checks the
  54. workspace without a model. Every quote must occur in its paper, and every
  55. citation must point to exactly one screened paper. Every number in a claim must
  56. appear in its quote, and every cited sentence in the synthesis must agree with a
  57. verified claim in its numbers, negation and direction. A number in an uncited
  58. sentence is flagged. When a check fails, the agent receives the findings and up
  59. to three rounds to repair them.
  60. | The review arrives as | Meaning |
  61. |---|---|
  62. | valid | every check passed |
  63. | valid with warnings | the checks passed, with caveats listed beside the review, such as support from an abstract only or a bibliography that could not be resolved online |
  64. | INVALID EVIDENCE | problems remained after repair; the draft opens with this warning and names what failed, so treat it as unverified and ask the agent to fix those items or check them yourself |
  65. The checks confirm that the review says what its sources say. They do not
  66. confirm that the sources are right, and they cannot judge meaning, so a sentence
  67. that calls a finding "proven" where the paper says "suggested" passes. Read the
  68. review as critically as you would any draft.
  69. To re-check a workspace yourself, run
  70. `python3 /path/to/co-researcher/skills/literature-review/scripts/validate_review.py --workspace review/{slug}`.
  71. Options, output formats and exit codes are in [docs/validate-review.md](docs/validate-review.md).
  72. How the checker was tested, what it catches and what still gets through are in
  73. [the report](https://coresearcher.poemswe.com/paper/), with a
  74. [technical write-up](https://coresearcher.poemswe.com/paper/write-up/) behind it.
  75. ## Research Toolchain
  76. The scripts in `skills/literature-review/scripts/` run through `uv`, and the other evidence-handling skills share them. Run `bash scripts/setup.sh` once to install `uv` and, optionally, store an OpenAlex API key.
  77. | Script | What it does |
  78. |--------|--------------|
  79. | `openalex_cli.py` | cross-disciplinary search over about 250M works |
  80. | `search_arxiv.py` | preprint search |
  81. | `europepmc_api.py` | life-science full text and citation chaining |
  82. | `read_paper.py` | DOI, arXiv ID or PMCID to markdown full text through legal open-access routes; warns on retractions |
  83. | `build_corpus.py` | merges search results into a deduplicated `corpus.json`, keeping screening decisions on re-runs |
  84. | `verify_citations.py` | resolves every citation against OpenAlex, Europe PMC and Crossref, and flags `mismatched`, `not_found` or `retracted` |
  85. | `prisma_counts.py` | PRISMA 2020 flow counts from `corpus.json` |
  86. | `check_claims.py` | checks each quote against its paper and each citation against the corpus |
  87. | `validate_review.py` | the offline gate that runs every check and writes an auditable JSON report |
  88. ## Evaluations
  89. The repository carries 34 broad quality cases across 10 capabilities, and a
  90. separate 16-case evidence-integrity set. Results are on the
  91. [Evals dashboard](https://coresearcher.poemswe.com/evals/). A broad quality
  92. score is not an integrity result. Running and publishing evals is covered in
  93. [evals/README.md](evals/README.md).
  94. ## Development
  95. ```bash
  96. PYTHONNOUSERSITE=1 uv run --no-project --with pytest --with 'pymupdf4llm<2' --with python-dotenv --with 'bibtexparser>=1.4,<2' python -m pytest -q tests
  97. ```
  98. The suite runs offline on fixture data. `tests/test_research_smoke.py` alone
  99. covers claim checking, PRISMA counts and the resumable research scaffold. An
  100. opt-in Codex smoke needs an authenticated Codex CLI:
  101. `CO_RESEARCHER_CODEX_SMOKE=1 uv run scripts/codex_smoke_research.py`.
  102. | Path | Holds |
  103. |---|---|
  104. | `skills/` | the research skills, one source for every platform |
  105. | `commands/` | platform commands (`.md` for Claude, `.toml` for Gemini) |
  106. | `.codex/`, `.opencode/` | launchers and install instructions |
  107. | `evals/` | quality and integrity cases, the runner and the dashboard |
  108. | `.claude-plugin/`, `gemini-extension.json`, `GEMINI.md` | manifests |
  109. ## Star History
  110. [![Star History Chart](https://api.star-history.com/svg?repos=poemswe/co-researcher&type=Date)](https://star-history.com/#poemswe/co-researcher&Date)
  111. ## License
  112. MIT. One optional runtime dependency, `pymupdf4llm` (with its `PyMuPDF` backend), is **AGPL-3.0**. `read_paper.py` uses it for PDF text extraction, and `uv` pulls it in only when that script runs. If you redistribute a service built on `read_paper.py`, the AGPL terms apply to that dependency. The Europe PMC JATS and OpenAlex abstract routes don't need it.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.