KB Ingest
Use this skill to turn a raw source into one durable markdown raw-source record. The record should be useful for local search and summary-level reasoning, while preserving original links so future agents can retrieve deeper details online.
Workflow
- Read the vault root
AGENTS.mdand follow any project-specific schema. - Identify the source kind: PDF, GitHub repository, web page, text/markdown file, or other.
- Collect metadata, original URLs, local paths, publication dates, authors, repository owner/name, branch, and commit when available.
- Inspect the source content carefully enough to write a faithful raw-source record.
- Create exactly one markdown record under the matching
knowledge-base/raw/folder using source-record-template.md. - For PDFs, follow pdf-ingest.md.
- For GitHub repositories, follow github-ingest.md.
- Preserve primary website links in raw-source properties and additional important links in
## Important Details. - Add
## Links Into Wikientries only for existing or newly created wiki pages. - Update
knowledge-base/wiki/index.mdandknowledge-base/wiki/log.mddirectly or invoke the index/log workflow if available. - If contradictions appear, append them to
knowledge-base/wiki/review.md; do not rewrite personal notes or contested wiki claims.
Writing Requirements
- Write concrete summaries, not promotional blurbs.
- Separate
Summary,Key Takeaways,Keywords and Concepts,Important Details, andOpen Questions. - Keep human-authored prose in
personal-notes/untouched. Useful wikilinks, citation links, backlinks, or frontmatter/property formatting may be added directly; ask for permission before adding or rewriting substantive personal-note content. - Prefer Obsidian wikilinks for local KB pages and normal markdown links for external URLs.
References
- source-record-template.md: shared raw-source record template.
- pdf-ingest.md: PDF and literature ingestion.
- github-ingest.md: GitHub repository ingestion.