How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/harisjavaid85/ai-agent-skills --skill kb-ingestBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
KB Ingest
Take sources into a file-based knowledge base: normalize → register. Stops at sources/index.md and writes nothing to knowledge/, which is kb-integrate's job.
1. Resolve the KB
Resolve which KB to operate on per registry.md. Done when you have its absolute root path.
2. Normalize and register each argument
An argument is either a source (URL, path, pasted text) or an already-registered key, since a caller re-running over what it ingested earlier holds keys rather than URLs. Resolve each against sources/index.md first, by key or by origin. ingestion.md's Idempotency rule governs the three cases:
- Unknown. Convert and register it.
- Known, status
candidateorintegrated. Refresh its metadata only; nothing is re-converted. - Known, status `declined`. A reopen, which re-converts. Confirm with the user first, per that rule. A confirmation passed in with the key counts; where no user can answer, skip it and report it as awaiting confirmation.
Run the pipeline in ingestion.md on each new or reopened source: convert, keep the originals, register the key. Done when every ingestible source has a normalized .md and an entry carrying every field the citation contract's registry schema lists, and every source left out is noted with its reason.
3. Report
List the ingested keys, each now a candidate; the known keys that were only refreshed; and the sources left out with their reasons, both those the fidelity guard skipped and each reopen refused or awaiting confirmation, with its prior decline and reason. Done when the user can see what entered sources/, what didn't, and that nothing has been integrated yet.
