lint

Scan Obsidian vaults for stale tasks, broken links, and frontmatter issues.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/brandtam/rubber-ducky --skill lint-brandtam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lint
Source: https://github.com/brandtam/rubber-ducky/tree/main/src/skills/lint
Command: npx skills add https://github.com/brandtam/rubber-ducky --skill lint-brandtam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill continuously audits a workspace to surface health issues that break consistency, slow progress, or cause missed standards.

Core Features & Use Cases

  • Stale tasks detection: identifies in-progress tasks older than 7 days with no activity and surfaces follow-up.
  • Frontmatter validation: checks workspace.md frontmatter fields and correctness.
  • Link integrity: scans for broken wikilinks within wiki/ directories.
  • Daily page gaps: detects gaps or empty sections in wiki/daily.
  • Terminology consistency: validates terms defined in UBIQUITOUS_LANGUAGE.md are used or defined in task pages.
  • Reports findings by severity (error, warning, info) to guide remediation.

Quick Start

Run the lint pass on your workspace to generate a health report.

Frequently Asked Questions about lint

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

FAQPage Schema
How do I check my Obsidian vault for broken wikilinks and missing frontmatter?

To check an Obsidian vault for broken wikilinks and missing frontmatter, run a workspace health audit that scans wiki/ directories and workspace.md to validate frontmatter fields and report link integrity issues by severity.

What is the best way to detect stale tasks in a markdown workspace?

The best way to detect stale tasks in a markdown workspace is to run an automated lint pass that scans the wiki/tasks/ directory to identify in-progress tasks older than 7 days with no activity and surfaces them for follow-up.

How do I validate ubiquitous terminology across my project documentation?

Validating ubiquitous terminology requires scanning task pages against UBIQUITOUS_LANGUAGE.md to verify that defined terms are properly used or defined, ensuring project documentation consistency and surfacing undefined terms in a structured report.

Can I find gaps in my daily notes using an automated workspace scan?

Yes, you can find daily notes gaps by running a workspace scan that targets the wiki/daily/ directory to detect missing entries or empty sections, categorizing the findings by severity to guide your remediation efforts.

Does frontmatter validation work on standard markdown files outside of an Obsidian vault?

Frontmatter validation is specifically designed for Obsidian-style vaults, targeting workspace.md and files within wiki/ directories, so it requires that specific structure to properly scan and report frontmatter field correctness.

Why does my workspace health report show undefined terms in my task pages?

A workspace health report shows undefined terms because the lint scan cross-references task pages with UBIQUITOUS_LANGUAGE.md, flagging any terminology used in tasks that lacks a corresponding definition to maintain documentation consistency.