# Lisa Wiki Connector Docs

> Ingest a local document (PDF…

- Skill: `codyswanngt/lisa-wiki-connector-docs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add codyswanngt/lisa-wiki-connector-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/codyswanngt/lisa-wiki-connector-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: codyswanngt (https://skillmd.com/u/codyswanngt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/codyswanngt/lisa-wiki-connector-docs

---


# lisa-wiki-connector-docs

Skill-driven connector. Converts a local document to markdown using whatever converter is available,
writes a source note, and hands off; the kernel does the rest.

## Converters (no bundled heavy dependency)
- **Markdown / text**: ingest directly.
- **PDF**: `pdftotext` (Poppler) if available, else `pandoc`.
- **DOCX**: `pandoc` if available, else `textutil` (macOS).
If no suitable converter is installed, **skip that source and record a `docs` doctor finding** (the
file could not be converted) so the user can install a converter — a targeted `/ingest <file>` reports
the skip rather than pretending success. Missing converters are connector-specific, never a
plugin-install blocker.

## Flow
1. Confirm `connectors.docs.enabled` and `sideEffects: read-only-ingest`.
2. Resolve the input file; pick the converter by extension; convert to markdown (read-only).
3. Write a source note under `wiki/sources/docs/<YYYY-MM-DD>-<slug>.md` with frontmatter
   (`type: source`, dates, `source_system: docs`, original filename) and the converted, reader-safe
   text. Redact secrets; honor `sourceRetention`/`sensitivity`.
4. Emit run metadata (source-note path) to the handoff file; return to `lisa-wiki-ingest`.

## Rules
- Read-only on the source document; never modify the original.
- Writes only the source note + handoff meta; the kernel advances state.