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.5 KiB

Raw Blame History

name	description
wiki-lint	Run a health check on the LLM Wiki vault — mechanical checks (orphans, broken links, stale pages, missing frontmatter, log gap, duplicates) plus semantic checks (contradictions, cross-reference gaps, concepts missing their own page). Outputs a markdown report with suggested actions. Usage /wiki-lint [--stale-days N] [--log-gap-days N]

/wiki-lint

Health-check the wiki. Surfaces orphan pages, broken wikilinks, stale claims, missing frontmatter, contradictions, and structural drift. Reports, doesn't silently fix — you decide what to change.

Run this weekly, after batch ingests, and always before sharing the wiki.

Usage

/wiki-lint
/wiki-lint --stale-days 60
/wiki-lint --log-gap-days 7

What happens

Pass 1 — Mechanical (scripts)

engineering/llm-wiki/skills/llm-wiki/scripts/lint_wiki.py — orphans, broken links, stale pages, missing frontmatter, duplicate titles, log gap
engineering/llm-wiki/skills/llm-wiki/scripts/graph_analyzer.py — hubs, sinks, connected components, graph stats

Pass 2 — Semantic (LLM reads and thinks)

Contradictions between recently-updated pages
Stale claims superseded by newer sources
Concepts mentioned in plain text across 3+ pages without their own page
Cross-reference gaps (entities mentioned but not wikilinked)
Index drift (index.md out of sync with wiki/)

Pass 3 — Report

A markdown report grouped by severity:

# Wiki lint — <date>

**Total pages:** N  **Components:** N  **Last log:** <date>

## Found
- ⚠️ <N> contradictions (list)
- <N> orphans
- <N> broken links
- <N> stale pages
- ...

## Suggested actions
1. Investigate contradiction between [[sources/a]] and [[sources/b]]
2. Create concept page for "<name>"
3. Fix broken link in [[concepts/x]]
4. Re-ingest [[sources/c]] — stale + contradicted
5. ...

Then appends a lint entry to log.md.

Sub-agent

Dispatches the wiki-linter sub-agent. See agents/wiki-linter.md.

Scripts

engineering/llm-wiki/skills/llm-wiki/scripts/lint_wiki.py
engineering/llm-wiki/skills/llm-wiki/scripts/graph_analyzer.py
engineering/llm-wiki/skills/llm-wiki/scripts/append_log.py

Frequency

Trigger	Pass
Weekly	Mechanical only — fast
After batch ingest	Full (mechanical + semantic)
Monthly	Full + structural review
Before sharing	Full + extra review

Skill Reference

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

2.5 KiB Raw Blame History