lint

Audits wiki content for sensitive data, contradictions, orphan pages, and broken links.

1|Updated Jul 6, 2026
One-click install
npx skills add https://github.com/citytexi/team-yg-pesonal-agent --skill lint-citytexi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lint
Source: https://github.com/citytexi/team-yg-pesonal-agent/tree/main/.claude/skills/lint
Command: npx skills add https://github.com/citytexi/team-yg-pesonal-agent --skill lint-citytexi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintaining a large LLM-operated knowledge wiki leads to accumulating quality issues: leaked sensitive data, contradictory pages, orphaned documents, broken links, and stale status metadata. This Skill runs a structured audit workflow over the entire wiki and produces a dated report of every issue found. ## Core Features & Use Cases - Automated mechanical checks: Runs wiki/script/lint.py and wiki/script/check-status.py to detect sensitive patterns (emails, API keys, passwords), frontmatter errors, link integrity violations, orphan pages, and status-chain inconsistencies. - Judgment-based review: Detects contradictions between pages, verifies resolved decisions are propagated downstream, identifies data gaps, and flags stale content that scripts cannot catch. - Governance enforcement: Checks provenance (cited sources match frontmatter), dependency direction (wiki must not link to implementation docs), and never auto-fixes sensitive data — it reports file and line numbers for user confirmation. - Use Case: After a week of wiki edits, ask the agent to lint the wiki; it runs the scripts, reviews the remaining judgment items, writes wiki/synthesis/lint-YYYY-MM-DD.md, and appends a summary entry to log.md. ## Quick Start Run the wiki lint to check the current state of the wiki and generate a report of any issues found.

Frequently Asked Questions about lint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check a Markdown wiki for broken links and orphan pages?▼

Run the lint workflow, which executes wiki/script/lint.py to check link integrity, inbound reference counts, and frontmatter validity across all wiki pages. Pages with zero inbound links are flagged as violations and pages with only one inbound link are flagged for review.

How to detect sensitive data like API keys in documentation?▼

The lint script scans the wiki for patterns matching emails, phone numbers, API keys, and passwords. Findings are never auto-fixed; the workflow reports the exact file and line number so the user can choose to delete, mask, or move the content to a private folder.

Does the wiki lint automatically fix the issues it finds?▼

Only status metadata issues (item 7) can be auto-fixed and then reported. Sensitive data findings require explicit user confirmation before any change, and no commits are allowed until they are resolved. Judgment items like contradictions are registered in open-questions.md.

What does the status integrity check validate in wiki sources?▼

The check-status.py script validates that sources/ frontmatter status fields exist and hold valid values, that superseded or partial entries declare superseded_by or scope, that supersession chains terminate at a current entry without cycles, and that index.md projections match.

Which wiki directories are excluded from lint checks?▼

The wiki/templates/ and wiki/script/ directories are excluded from orphan page, broken link, frontmatter, and status checks because placeholder links in templates cause false positives. Templates that drift from the current schema are still flagged as stale content.