P
PaoloTCS/research-box
An Agent Skill that bundles related research work into named boxes with sharing levels, checksums and RO-Crate metadata.
updated 2026-11-19
View on GitHub ↗Direct link · no redirect page
After install: how to tell it works
- What you see after install — The command exits 0 and the terminal shows no "command not found" or "permission denied".
- One-line self-check — Run the smallest usage example from that repository's README. If the output matches what the README describes, it is working.
- If that does not work — This project has no troubleshooting notes. Search its issues for "install".
The install command comes from the repository; these checks describe observable results only and do not replace the project's own docs.
- Star count
- 0 ★ · PaoloTCS/research-box · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-20 · last seen 2026-11-20 · seen 1× · listed by 2 sources
- Score
- score 203 · 2 sources · repo
- Install
- see Install & config above
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Agent skills. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
PaoloTCS/research-box;first catalogued 2026-11-20;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# research-box
Excerpted from the repository README (abridged)
An Agent Skill for keeping related research work together: documents, spreadsheets, diagrams, code, data, chats and agent tasks bundled into a named box, with sharing levels that only narrow.
Say "make a box called prime-numbers", "add this sheet to the box", "drop the box about prime numbers", "open box prime-numbers" or "give the box to my other agent", and the agent knows what to do.
Live layer: links that stay current. Agents of the same assistant hand each other links, not files.
Snapshot layer: a dropped folder with exported files, a readable BOX.md, an RO-Crate 1.1 ro-crate-metadata.json, and SHA-256 checksums of every file.
Sharing levels: private, same assistant, shareable. A drop for wider readers leaves out what is not cleared for them, writes a clean copy that holds nothing else, and says what it left out.
Checks: --check tells you whether any file in a drop, including its own description, changed or was copied stale, and a list of watch words flags private terms that are about to leave in a shareable drop.
## Quick demo
From a clone of this repository, using the example box in examples/prime-numbers:
$ python3 research-box/scripts/build_box.py examples/prime-numbers --for shareable --out /tmp/prime-share
prime-numbers: 2 item(s) kept, 2 file(s) checksummed, written to /tmp/prime-share
Left out for shareable readers: Working notes, Planning chat
Watch words in code/simulate.py: Project Lantern (advisory; --strict refuses the drop)
$ python3 research-box/scripts/build_box.py /tmp/prime-share --check
All files match the manifest.
$ printf '\n# edited\n' >> /tmp/prime-share/sheet/results.csv
$ python3 research-box/scripts/build_box.py /tmp/prime-share --check
Changed since the last drop: sheet/results.csv
--check exits 0 when the drop matches its manifests and 1 after the edit. Add --strict to the first command and the drop is refused until the watch word is removed.
## Contents
research-box/
SKILL.md instructions the agent follows
references/box-format.md the box.json format and how it relates to RO-Crate and BagIt
scripts/build_box.py writes BOX.md, RO-Crate metadata and checksum manifests; checks drops
assets/box.example.json an example box
LICENSE Apache License 2.0
NOTICE copyright and attribution
.claude-plugin/ plugin manifest, marketplace file and icon
examples/prime-numbers/ a small box to try the script on
tests/test_build_box.py unittest suite, standard library only
build_box.py uses the Python standard library only.
## Try it
The commands and the output in Quick demo were run against this revision. To run the 23-test suite:
python3 -m unittest discover tests
The example box has one item at each sharing level and a watch word left in a shareable file, so each safeguard shows. The tests cover the drop rules, labels, path containment, watch words and the check's exit status.
Manifests can also be verified without the script: shasum -a 256 -c manifest-sha256.txt.
## Install
The skill follows the open Agent Skills format (agentskills.io). Copy the research-box folder into your agent's skills directory, or upload it as a skill in an app that supports skills. You can also install it with the skills CLI:
Say "make a box called prime-numbers", "add this sheet to the box", "drop the box about prime numbers", "open box prime-numbers" or "give the box to my other agent", and the agent knows what to do.
Live layer: links that stay current. Agents of the same assistant hand each other links, not files.
Snapshot layer: a dropped folder with exported files, a readable BOX.md, an RO-Crate 1.1 ro-crate-metadata.json, and SHA-256 checksums of every file.
Sharing levels: private, same assistant, shareable. A drop for wider readers leaves out what is not cleared for them, writes a clean copy that holds nothing else, and says what it left out.
Checks: --check tells you whether any file in a drop, including its own description, changed or was copied stale, and a list of watch words flags private terms that are about to leave in a shareable drop.
## Quick demo
From a clone of this repository, using the example box in examples/prime-numbers:
$ python3 research-box/scripts/build_box.py examples/prime-numbers --for shareable --out /tmp/prime-share
prime-numbers: 2 item(s) kept, 2 file(s) checksummed, written to /tmp/prime-share
Left out for shareable readers: Working notes, Planning chat
Watch words in code/simulate.py: Project Lantern (advisory; --strict refuses the drop)
$ python3 research-box/scripts/build_box.py /tmp/prime-share --check
All files match the manifest.
$ printf '\n# edited\n' >> /tmp/prime-share/sheet/results.csv
$ python3 research-box/scripts/build_box.py /tmp/prime-share --check
Changed since the last drop: sheet/results.csv
--check exits 0 when the drop matches its manifests and 1 after the edit. Add --strict to the first command and the drop is refused until the watch word is removed.
## Contents
research-box/
SKILL.md instructions the agent follows
references/box-format.md the box.json format and how it relates to RO-Crate and BagIt
scripts/build_box.py writes BOX.md, RO-Crate metadata and checksum manifests; checks drops
assets/box.example.json an example box
LICENSE Apache License 2.0
NOTICE copyright and attribution
.claude-plugin/ plugin manifest, marketplace file and icon
examples/prime-numbers/ a small box to try the script on
tests/test_build_box.py unittest suite, standard library only
build_box.py uses the Python standard library only.
## Try it
The commands and the output in Quick demo were run against this revision. To run the 23-test suite:
python3 -m unittest discover tests
The example box has one item at each sharing level and a watch word left in a shareable file, so each safeguard shows. The tests cover the drop rules, labels, path containment, watch words and the check's exit status.
Manifests can also be verified without the script: shasum -a 256 -c manifest-sha256.txt.
## Install
The skill follows the open Agent Skills format (agentskills.io). Copy the research-box folder into your agent's skills directory, or upload it as a skill in an app that supports skills. You can also install it with the skills CLI:
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/paolotcs-research-box/)
- Source
- github · https://github.com/PaoloTCS/research-box
- Browse by field
- Agent skills
- Listed by
- 2 independent sources
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.