https://github.com/Intelligent-Internet/II-Commons-Skills
Fast, daily-updated skill and CLI for arXiv, PubMed, PMC, and policy retrieval
https://github.com/Intelligent-Internet/II-Commons-Skills
arxiv cli daily-updated ii-commons pmc policy pubmed research retrieval skill
Last synced: 8 days ago
JSON representation
Fast, daily-updated skill and CLI for arXiv, PubMed, PMC, and policy retrieval
- Host: GitHub
- URL: https://github.com/Intelligent-Internet/II-Commons-Skills
- Owner: Intelligent-Internet
- License: apache-2.0
- Created: 2026-05-25T13:01:07.000Z (18 days ago)
- Default Branch: main
- Last Pushed: 2026-05-28T13:42:19.000Z (15 days ago)
- Last Synced: 2026-06-01T10:36:03.064Z (11 days ago)
- Topics: arxiv, cli, daily-updated, ii-commons, pmc, policy, pubmed, research, retrieval, skill
- Language: JavaScript
- Homepage: https://commons.ii.inc/
- Size: 2.62 MB
- Stars: 9
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-bioie - II-Commons - A Node.js CLI and agent skill for deterministic, daily-updated retrieval across PubMed/PMC, arXiv, and supported US policy corpora, with metadata lookup and full-document Markdown retrieval. (Tools, Platforms, and Services / Repos for Specific Datasets)
- awesome-datascience - II-Commons - Daily-updated skill and CLI for deterministic retrieval across arXiv, PubMed/PMC, and supported US policy corpora. (Agents / Research & Knowledge Retrieval)
- fucking-awesome-datascience - II-Commons - Daily-updated skill and CLI for deterministic retrieval across arXiv, PubMed/PMC, and supported US policy corpora. (Agents / Research & Knowledge Retrieval)
- awesome-scientific-skills - Intelligent-Internet/II-Commons-Skills - updated skill and CLI for deterministic retrieval across arXiv, PubMed/PMC, and supported US policy corpora | (Skill Sources / Science-Specific)
README
# II-Commons-Skills
[](https://commons.ii.inc/)
[](LICENSE)
[](https://github.com/Intelligent-Internet/II-Commons-Skills)
II-Commons-Skills provides fast, daily-updated deterministic retrieval across arXiv, PubMed / PMC, and supported US policy corpora.
## Links
- Web app and API token requests: https://commons.ii.inc/
- Source repository: https://github.com/Intelligent-Internet/II-Commons-Skills
- Retrieval engine: [psql_bm25s](https://github.com/Intelligent-Internet/psql_bm25s), a PostgreSQL BM25S extension powering fast lexical retrieval.
## For Humans: How to Use It
Send this to your agent:
```txt
Please add this skill for me:
https://github.com/Intelligent-Internet/II-Commons-Skills.git
And tell me the value of this skill.
```
After the skill is installed, use it through your agent:
```txt
Please use the `ii-commons` skill to answer this: ...
```
## For Agents: How to Use It
### Install
The npm package is published as `@intelligentinternet/ii-commons`.
Run the CLI with npx:
```bash
npx @intelligentinternet/ii-commons cutoff
```
Or install it globally:
```bash
npm install -g @intelligentinternet/ii-commons
ii-commons cutoff
```
The CLI requires Node.js 18 or newer.
To install as an agent skill, install the `skills/ii-commons/` folder as a skill named `ii-commons` in your agent runtime's native skill discovery path. If your runtime supports repository URL installs, point it at `skills/ii-commons/`.
```bash
node scripts/ii_commons.js --help
```
### Usage
For `search`, use exactly this shape: `search [filters]`. Put the quoted topic immediately after the corpus, then append filters.
```bash
ii-commons cutoff
ii-commons search arxiv "large language model inference" --max-results 10
ii-commons search pubmed "type 2 diabetes review" --start 20240000 --max-results 10
ii-commons search policy "state overtime rule for agricultural workers" --jurisdictions US-CA --max-results 10
ii-commons meta "arXiv:2402.03578"
ii-commons markdown "PMCID:PMC11152602"
```
`cutoff` returns the latest available corpus coverage date for each corpus. For freshness-sensitive requests, run `cutoff` first and report the returned date.
The CLI writes JSON to stdout. Errors are machine-readable JSON on stderr.
### Auth
Basic usage works without authentication. For higher usage limits, request an API token at https://commons.ii.inc/ and configure it with `II_COMMONS_API_KEY` or the local `ii-commons` config file.
## License
[Apache-2.0. ](LICENSE).