mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-08-28 04:24:58 +00:00

fix: phantom-path sweep — 888 unresolvable references to zero

A directory reorg added a skills/ path segment; hundreds of references never
followed. This sweep repoints every path-like reference in SKILL.md, agents,
commands, orchestration, and templates to verified on-disk targets:

- 30 root commands + 19 root agents: missing skills/ segment inserted
- 7 c-level persona agents: 17 hallucinated reference filenames substituted
  with the real files (e.g. okr_execution.md -> process_frameworks.md)
- 5 research skills: phantom scripts/office/validate.py step replaced with a
  runnable stdlib zip-integrity check
- email agents: skills frontmatter corrected to productivity/email
- orchestration/ORCHESTRATION.md + templates: stale paths fixed;
  agent-template now requires trigger phrasing in descriptions (root cause)
- 76 more files across engineering, c-level-advisor, compliance-os,
  research-ops, ra-qm, marketing, productivity; dual-publish pairs mirrored
- dead refs dropped/replaced where no target ever existed (REGISTRY.md,
  trend_analyzer.py, cursor-microinteractions.md)

New: scripts/check_paths.py linter (CI gate G1) + narrow allowlist for
teaching examples. Verified: 540 files scanned, 0 unresolvable.

https://claude.ai/code/session_019AJddAL1NADWMXsy1qNPQF

2026-06-10 14:33:00 +00:00

2.3 KiB

Raw Blame History

name	description
wiki-ingest	Ingest a source file from raw/ into the LLM Wiki — read, discuss, write summary page, update cross-references across 5-15 pages, regenerate index, append to log. Usage /wiki-ingest <path-to-source>

/wiki-ingest

Ingest a new source into the LLM Wiki. This is the most-used command.

The flow: read the source → discuss TL;DR and key claims with you → write a source summary page → update every relevant entity and concept page → flag contradictions → update index.md → append to log.md.

A typical ingest touches 5-15 wiki pages. You (the user) are in the loop: the ingestor proposes changes and waits for your confirmation before writing.

Usage

/wiki-ingest <path>
/wiki-ingest raw/papers/monosemanticity.pdf
/wiki-ingest raw/articles/2026-04-01-interpretability-post.md

What happens

Prep — runs engineering/llm-wiki/skills/llm-wiki/scripts/ingest_source.py to get title, preview, and suggested summary path
Read — reads the source directly
Discuss — reports TL;DR, key claims, which pages will be touched, any contradictions
Confirm — waits for your go-ahead (or redirects)
Write — creates the source summary, updates 5-15 pages, flags contradictions
Index — runs engineering/llm-wiki/skills/llm-wiki/scripts/update_index.py or edits wiki/index.md inline
Log — runs engineering/llm-wiki/skills/llm-wiki/scripts/append_log.py --op ingest --title "<title>"
Report — bulleted wikilinks to every touched page

Sub-agent

This command dispatches the wiki-ingestor sub-agent for the heavy lifting. See agents/wiki-ingestor.md.

Scripts

engineering/llm-wiki/skills/llm-wiki/scripts/ingest_source.py — source prep (metadata + preview)
engineering/llm-wiki/skills/llm-wiki/scripts/update_index.py — regenerate index
engineering/llm-wiki/skills/llm-wiki/scripts/append_log.py — log the ingest

Rules

The source must be inside the vault's raw/ layer. If it isn't, the command will ask you to move it first.
raw/ is immutable — the ingestor reads only.
If a summary page already exists, the ingestor enters merge mode and appends a re-ingest section.

Skill Reference

→ engineering/llm-wiki/skills/llm-wiki/SKILL.md → engineering/llm-wiki/skills/llm-wiki/references/ingest-workflow.md

2.3 KiB Raw Blame History