scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-10-09 03:17:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
claude-skills/docs/commands/wiki-lint.md
Claude 82c5aea9f0
Merge origin/dev: reconcile docs redesign with upstream skill changes 
- Resolve conflicts: keep redesigned skills index, take dev's cs-aeo link
  fix, union of DOMAIN_SEO_CONTEXT entries in generate-docs.py
- Regenerate catalog on the merged tree (dev's agent/command description
  updates, removed ai-seo/release-manager/command-guide, restructured
  universal-scraping-architect)
- Update counters to post-merge truth from scripts/derive_counters.py:
  345 skills, 78 plugins (14 bundles + 64 standalone), 570+ Python tools
- Add redirects for upstream-removed pages (ai-seo -> aeo,
  release-manager -> changelog-generator, command-guide -> engineering index)
- Add compliance-os bundle to bundle tables; rebuild 78-plugin table from
  marketplace.json
- Teach the generator to rewrite repo-root-relative source links to GitHub
  URLs — mkdocs build --strict now passes with zero warnings

https://claude.ai/code/session_015bYZ97nV4oRb3LbxCRFVcP
2026-06-11 15:52:42 +00:00

2.8 KiB
Raw Permalink Blame History

title description
/wiki-lint — Slash Command for AI Coding Agents Run a health check on the LLM Wiki vault — mechanical checks (orphans, broken links, stale pages, missing frontmatter, log gap, duplicates) plus. Slash command for Claude Code, Codex CLI, Gemini CLI.

/wiki-lint

:material-console: Slash Command :material-github: Source

/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