Llm wiki lint
Three agent skills to set up, ingest into, and lint a Karpathy-style agent-maintained wiki in your repo
npx -y skills add tylensthilaire/skill-llm-wiki --skill llm-wiki-lintAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Health-check the project's agent-maintained wiki and produce a lint report: dead links, orphan docs, contradictions, stale claims, coverage gaps, index drift, and suspected duplicates. Use this whenever the user asks to lint, health-check, audit, or tidy the wiki or knowledge base; whenever they ask "is the wiki up to date" or "how healthy is the knowledge base"; after any large batch of ingests; and whenever the due check shows a lint is due (no lint entry in the log within the threshold).
The file declares its own license as Artistic-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
3.0 KB, 569 tokens by cl100k_base, as published. Nobody here has run it
Wiki lint
Keep the wiki healthy as it grows: catch the any broken or missing cross-links that appear over time. Report and repair safe things; never destroy.
Step 0 — due check
To decide whether a lint is due (other skills can call this, e.g. at the end
of llm-wiki-ingest):
grep "^## \[" wiki/log.md | tail -20
A lint is due if, since the last lint entry, there have been 10+ ingests
or 14+ days (defaults; a project may override them in its conventions doc).
When called only for the due check, report due/not-due and stop.
To run lint unattended on a schedule, see references/scheduling.md —
scheduling belongs to your environment, not the skill.
Checks (run in order)
- Structure — docs missing from
index.md; index entries pointing at missing files. - Dead links — links to docs or raw files that don't exist.
- Orphans — docs with no inbound links. Suggest which docs should link to them.
- Contradictions — docs that disagree with each other; claims a newer source has superseded. Cite both sides.
- Coverage gaps — entities or concepts mentioned across several docs that
lack their own doc. Flag for
llm-wiki-ingest/the human; don't create content docs during lint. - Bloat and duplicates — near-identical docs, or docs that have collected content belonging elsewhere. Flag with a proposed merge; never delete on your own.
Repairs
Apply without asking: index entries for existing unlisted docs, and obviously broken relative links with one clear target. Everything else — deletions, merges, content rewrites, contradiction fixes — goes in the report as a proposed action needing approval.
Report
Write the report as a dated doc under wiki/ (linked from the index — lint
findings are project knowledge too), with sections matching the checks, an
overall status line (green / yellow / red), and a numbered next-steps list
marking which actions need approval. Append to the log:
## [YYYY-MM-DD] lint | <status>: <one-line summary>.
Hard rules
- Never delete files on your own.
- Never create content docs during lint (reports excepted) — creating docs is ingest's job.
- Never change
raw/. - Always log the pass, even when everything is green — the due check depends on it.