rw-research-passport

Original：🇨🇳 Chinese

Translated

2 scriptsChecked / no sensitive code detected

Set up and maintain an auditable JSON status file for a single research project, recording research phases, materials, judgments, unknowns, handovers, and change logs. Use when the user asks for "establish research archives", "save the material status of this research project", "hand over literature, judgments, and next steps to another research Skill", "check research status files", or requests the rw-research-passport workflow.

3installs

Sourcerolandwonglonam/rw-research-skill

Added on2026-07-20

NPX Install

npx skill4agent add rolandwonglonam/rw-research-skill rw-research-passport

SKILL.md Content (Chinese)

View Translation Comparison →

RW Research Passport

Save the current status for a research project. The Passport is a handover document, not a literature library, nor a replacement for original materials.

Initiation

Read

references/method.md

and

references/schema.md

.

Copy

assets/passport-template.json

when creating a new file, or run

scripts/passport.py init

.

Run
```
scripts/passport.py validate
```
when checking existing files, then read the original materials to verify key fields.
Read
```
references/axioms.md
```
and
```
references/cases.md
```
when boundary judgments are needed.
Read
```
references/acceptance.md
```
before delivery.

Work Phases

Keep the user's original question, project scope, and current research phase.
Assign a stable ID to each material, record its path or identifier, status, and addition time.
Record judgments, unknowns, and rejected directions separately; do not present inferences as facts.
When handing over to the next Skill, only pass the required material IDs and record the handover status.
Append audit records for each modification; do not overwrite the reasons for changes.
Run validation and output the current status, gaps, next steps, and stop conditions.

Commands

bash

python3 scripts/passport.py init project-passport.json --project-id PROJECT-ID --title "Project title"
python3 scripts/passport.py add-material project-passport.json --id MAT-001 --type paper --title "Paper title" --source-pointer "doi:..." --status verified
python3 scripts/passport.py add-material project-passport.json --id MAT-002 --type paper --title "Updated paper" --source-pointer "path-or-id" --content-sha256 SHA256 --supersedes-id MAT-001
python3 scripts/passport.py validate project-passport.json
python3 scripts/passport.py summary project-passport.json

The script only processes JSON. Original materials can be local paths, DOIs, PMIDs, URLs, or other stable identifiers.

Operating Rules

One Passport corresponds to only one research project.
The Passport stores pointers and status, not full copies of papers.
```
verified
```
only indicates that the specified verification is completed, not automatically that the research quality is high.
Judgments must be linked to material IDs or clearly marked as current inferences.
Unknowns cannot be automatically closed due to process advancement.
Only pass materials required for the current phase during handover; avoid treating the entire workspace as context.
After the hash of original materials changes, old materials and dependent judgments can no longer be used as confirmed inputs; follow the version change process in
```
references/method.md
```
.
Do not use the Passport as cross-project personal memory.

Outputs

Verifiable Passport JSON.
Current phase, material status, confirmed judgments, unknowns, and next steps.
Validation errors and reasons for inability to proceed.

Stop Conditions

Do not mark the corresponding material as
```
verified
```
when the original material cannot be found.
Stop writing when project ID, material ID, or handover ID is duplicated.
Stop handover when key judgments have no material or inference tags.

Follow-up Tasks

Literature extraction:
```
rw-paper-extractor
```
.
Evidence organization:
```
rw-evidence-map
```
.
Paper writing:
```
rw-phd-write
```
.
Claim verification:
```
rw-claim-audit
```
.