$npx -y skills add pariyar07/ariadne --skill research-ingestUse when routing a new article, paper, repository, dataset, transcript, chat, observation, generated analysis, or other research input into a named Markdown knowledge-vault scope, especially when pipeline readiness or conditional synthesis must be decided.
| 1 | # Ariadne Research Ingest |
| 2 | |
| 3 | Orchestrate one research input without taking over compilation or synthesis ownership. No write begins until the research target and a closed write set are explicit. |
| 4 | |
| 5 | ## Authorization Gate |
| 6 | |
| 7 | 1. Read applicable instructions from the vault root through every ancestor scope to the candidate target. Read root and local indexes, agent navigation, routing matrices, and the candidate research hub or boundary descriptor progressively. |
| 8 | 2. Discover candidate scopes and descriptors read-only. Do not scan the whole vault by default. |
| 9 | 3. In a multi-scope vault, require a current-turn named or confirmed target scope. A search hit, one likely match, an existing card, prior conversation, current directory, or active skill is not confirmation. |
| 10 | 4. Construct and state `allowed_write_set` before any mutation. Include the target subtree plus each individually named parent hub, routing matrix, root Base formula, or other external file required for discoverability. An unnamed parent or root file is outside the set even when the edit seems minimal. |
| 11 | 5. If the target is missing or ambiguous, ask one short target question and stop before writing. If another required path appears later, extend the write set only after explicit confirmation; otherwise defer it. |
| 12 | |
| 13 | ## Classify The Input |
| 14 | |
| 15 | Record its real `source_type` and one evidence role: `external-evidence`, `first-party-evidence`, `context`, `hypothesis`, `generated-analysis`, or `derivative-copy`. |
| 16 | |
| 17 | Use `derived_from` for upstream provenance. Generated analysis and derivative copies require upstream links and never count as independent corroboration. Preserve chats, observations, hypotheses, and human notes as their actual epistemic role. Do not invent an inquiry solely to complete metadata; use `inquiry_links: []` until one is known. |
| 18 | |
| 19 | Inspect pipeline readiness through the boundary descriptor and local hubs. A supported descriptor has `type: research-boundary`, `research_schema`, a stable `boundary_id`, `scope_path`, and path-qualified canonical hub links. If repeatable topology is missing, invoke `ariadne:research-pipeline` only within the confirmed write set. Do not silently adopt a legacy pipeline. |
| 20 | |
| 21 | ## Handoff Envelope |
| 22 | |
| 23 | Produce this complete envelope before invoking a write-capable companion: |
| 24 | |
| 25 | ```text |
| 26 | target_scope |
| 27 | research_boundary |
| 28 | allowed_write_set |
| 29 | source_type |
| 30 | evidence_role |
| 31 | derived_from |
| 32 | inquiry_links |
| 33 | pipeline_state |
| 34 | requested_operation |
| 35 | ``` |
| 36 | |
| 37 | Use vault-relative paths or path-qualified links. Set `pipeline_state` to the observed state, such as `ready`, `missing`, `legacy`, or `needs-review`. Make `requested_operation` explicit, such as `capture-and-compile`, `source-only`, or `capture-compile-and-consider-synthesis`. |
| 38 | |
| 39 | ## Ownership And Completion |
| 40 | |
| 41 | 1. Invoke `ariadne:knowledge-capture` with the envelope. It may write raw and compiled artifacts only inside `allowed_write_set`; it does not select scope, create research topology, or judge synthesis disposition. |
| 42 | 2. Invoke `ariadne:research-synthesis` only when the new compiled material may change, confirm, contradict, supersede, or otherwise affect current understanding. Only that skill records the disposition. |
| 43 | 3. Capture one canonical raw source. Link related scopes rather than duplicating it. |
| 44 | 4. Run scoped validation after structural research work when available. Report deferred wiring, unresolved classification, legacy adoption, or out-of-set changes explicitly. |
| 45 | |
| 46 | Do not auto-promote research, create a scope for one source, or hide useful material only in chat. |