mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-10-09 03:17:54 +00:00
82c5aea9f0
- 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
92 lines
2.8 KiB
Markdown
92 lines
2.8 KiB
Markdown
---
|
|
title: "/wiki-lint — Slash Command for AI Coding Agents"
|
|
description: "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
|
|
|
|
<div class="page-meta" markdown>
|
|
<span class="meta-badge">:material-console: Slash Command</span>
|
|
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/commands/wiki-lint.md">Source</a></span>
|
|
</div>
|
|
|
|
<!-- canonical copy: engineering/llm-wiki/commands/wiki-lint.md — keep in sync (root copy uses repo-root-relative script paths) -->
|
|
|
|
# /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:
|
|
|
|
```markdown
|
|
# 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`
|