research-lint
Research Lint performs health checks on your research directory, identifying orphaned sources, missing entity hubs, broken wikilinks, stale claims, and contradictions. The skill runs seven checks—four fast mechanical scans plus optional LLM-powered analysis—and auto-applies safe edits like appending new contradictions and open questions while flagging issues that need your judgment.
Research Lint audits your research wiki and surfaces structural issues like orphaned sources, broken links, and contradictions.
AI-generated summary based on this skill's SKILL.md
Install
iusztinpaul/ai-research-os-workshop/research-lint · repository language: Python
git clone https://github.com/iusztinpaul/ai-research-os-workshop
cp -r ai-research-os-workshop/plugins/ai-research-os/skills/research-lint ~/.claude/skills/research-lintFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does research-lint do?
Research Lint performs health checks on your research directory, identifying orphaned sources, missing entity hubs, broken wikilinks, stale claims, and contradictions. The skill runs seven checks—four fast mechanical scans plus optional LLM-powered analysis—and auto-applies safe edits like appending new contradictions and open questions while flagging issues that need your judgment.
How do I lint my research directory?
Research Lint scans your research folder by running automated checks that detect structural and content issues. You can trigger a full health check to identify problems like orphaned sources, broken links, missing entity pages, and stale claims. The skill generates an audit report with actionable items for maintenance.
What issues can research-lint find and flag?
Research Lint detects orphaned sources, broken wikilinks, missing entity hubs, contradictions within your documentation, and stale claims. It also identifies research gaps and synthesizes open questions for further investigation, helping you spot both mechanical problems and content quality issues.
Can research-lint check the wiki for issues automatically?
Yes. Research Lint runs seven automated checks—four fast mechanical scans plus optional LLM-powered analysis—to validate your research structure and flag problems. It auto-applies safe edits and generates a comprehensive audit report with recommendations for your research directory.
What happens after research-lint detects contradictions?
Research Lint detects contradictions and stale claims within your research documentation and flags them for your review. The skill can auto-append new contradictions and open questions to relevant pages while marking issues that require your judgment before any changes are made.
Does research-lint validate research structure?
Research Lint validates your research structure by running health checks that identify missing entity hubs, orphaned sources, and broken links. It performs both mechanical validation and optional LLM-powered analysis to ensure your research directory is well-organized and internally consistent.
SKILL.md
rendered from the published skill — quoted content, verbatim
Research Lint
You audit a research directory and surface health issues. Lint is user-triggered, never automated. Each pass is read-mostly: you write only to wiki/open-questions.md, wiki/contradictions.md, index.yaml, index.md, and log.md — never to source pages, entity pages, concept pages, or raw files.
This skill answers: "what's broken or thin in this wiki, and what should I research next?"
Step 1 — Locate the research dir
Same logic as /research (query mode):
1. If the user provides a path, use
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 7 files
plugins/ai-research-os/skills/research-lint/SKILL.md
plugins/ai-research-os/skills/research-lint/agents/lint_judge.md
plugins/ai-research-os/skills/research-lint/scripts/_lintlib.py
plugins/ai-research-os/skills/research-lint/scripts/lint_broken_links.py
plugins/ai-research-os/skills/research-lint/scripts/lint_missing_comparisons.py
plugins/ai-research-os/skills/research-lint/scripts/lint_missing_hubs.py
plugins/ai-research-os/skills/research-lint/scripts/lint_orphans.py