ov-add-paper
Load when the user asks to add, import, compile, or ingest a research paper/PDF into OpenViking, especially when they mention ov-add-paper, ARA, claims, evidence, figures, tables, or paper-to-OV knowledge resources.
How do I install this agent skill?
npx skills add https://github.com/volcengine/openviking --skill ov-add-paperIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill automates the ingestion of research papers into the OpenViking platform by converting them into a structured 'Agent-Native Research Artifact' (ARA). It includes a dedicated validation script and utilizes the platform's official CLI for secure data management.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
ov-add-paper
Goal
Turn a research paper into an OpenViking-ready structured resource, then complete ingestion with ov add-resource. The job is not done until the generated artifact directory has been validated and submitted to OpenViking.
Inputs
- Required: a paper source, usually a local PDF path or paper URL.
- Optional: output directory, OpenViking target URI, domain notes, related repo/source files, and whether to wait for OV processing.
- If the paper source is missing or inaccessible, ask for it before starting.
Workflow
- Read the paper completely, including appendices and all numbered figures/tables.
- Compile an ARA-style artifact directory using
references/ara-compiler-profile.md. - Validate the artifact with
scripts/validate_ara.py. - Fix validation failures unless the user explicitly accepts them.
- Ingest the validated artifact directory with
ov add-resourcedirectly. - Confirm the target with
ov stat/ov treeand return the artifact path, OV target/root URI, validation result, ingest result, and any unresolved gaps.
Output Contract
The generated artifact must include:
PAPER.mdlogic/problem.md,logic/claims.md,logic/concepts.md,logic/experiments.md,logic/related_work.mdlogic/solution/constraints.mdsrc/environment.mdtrace/exploration_tree.yamlevidence/README.md- Markdown plus PNG evidence files for every filed numbered table and figure
The final response must include the ov add-resource command result, or the recovery checks proving the target landed despite a broken --wait, or the exact blocker that prevented ingestion.
Verification
Run from this skill directory, or use an absolute path to the validator:
python3 scripts/validate_ara.py <artifact-dir>
Then ingest with the OV CLI:
ov add-resource <artifact-dir> --to viking://resources/papers/<slug> --wait
Before ingest, use ov -o json stat <target-uri> to check whether the target already exists. After ingest, verify with ov -o json stat <target-uri> and ov tree <target-uri>.
Permissions
- Writing a new OpenViking resource is allowed when the user asked to add or ingest the paper.
- Ask before intentionally reusing a target URI that may overwrite or replace an existing resource.
--skip-validationmay be used only when the user explicitly accepts the listed validation errors.
Boundaries
- Do not use
ov add-skill; this skill creates paper resources, not OV skills. - Do not silently skip
ov add-resource; if ingestion fails, report the command, error, and recovery path. - If
ov add-resource --waitexits with a connection error after creating the target, do not immediately retry the same URI. Runov stat,ov wait,ov observer queue, andov treeto determine whether ingestion completed. - Do not invent claims, evidence, source refs, code, numbers, or research history.
- Do not overwrite an explicit existing OV target unless the user asked for that target.
- Mark unsupported or unreadable content as unavailable instead of filling it in.
Runtime Resources
- Load
references/ara-compiler-profile.mdbefore compiling the artifact. - Load
references/openviking-ingest.mdbefore running OV ingestion or debugging an ingestion failure. - Use
scripts/validate_ara.pyfor deterministic checks.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/volcengine/openviking/ov-add-paper">View ov-add-paper on skillZs</a>