What problem does it solve?
JellyRock's documentation can accumulate broken markdown links, invalid related-files frontmatter paths, stale tech-debt anchor references, and outdated architecture docs that haven't been reviewed in months. Manually catching these issues is time-consuming and error-prone, leading to broken references for users and blocked PRs during CI checks.
Core Features & Use Cases
- Reference Integrity Checks: Runs automated validation to catch broken related-files paths, inline markdown links, and stale tech-debt anchors across all JellyRock documentation.
- Stale Doc Detection: Identifies architecture docs whose last-reviewed date is past the 90-day threshold, flagging ones that need updating if their related file territory was modified in a PR.
- Structured Fix Suggestions: Categorizes all found issues and provides actionable, context-aware fix proposals for each error type, eliminating guesswork for contributors.
- Use Case: When preparing a PR that modifies JellyRock's docs or architecture files, run this skill to catch all documentation issues before pushing, avoiding CI failures and reducing review back-and-forth.
Quick Start
Use the docs-lint skill to run all JellyRock docs governance checks and get a categorized list of fixes for any broken links, stale references, or outdated docs found.