How does the AI slop detection work?

The skill integrates with the scribe tool to identify 'Tier 1' AI markers like 'delve' or 'tapestry' and structural issues like sentence uniformity, helping you maintain a human-centric technical tone.

Can this skill help with large, bloated documentation files?

Yes, it features a consolidation step that scans for files exceeding specific line thresholds (500 for docs, 1000 for books) and suggests merging or splitting them to improve readability.

When should I use doc-updates versus update-readme?

Use doc-updates for general documentation across multiple locations like wikis, ADRs, and docstrings. For updates strictly limited to a single README file, the specialized update-readme skill is more efficient.

What is LSP-enhanced verification?

It uses the Language Server Protocol to semantically verify that public functions are documented, parameters match actual code signatures, and return types are accurately described.

Documentation Quality Guardian

Name: Documentation Quality Guardian
Author: micsapp

bymicsapp

0•

学習とドキュメンテーション

Automates documentation updates with built-in quality gates, style enforcement, and AI-generated content detection.

The Documentation Quality Guardian (doc-updates) is a comprehensive skill designed to keep project documentation in perfect sync with code changes. It automates the identification of documentation targets across READMEs, wikis, and Architecture Decision Records (ADRs) while enforcing strict directory-specific style rules and technical accuracy. By integrating advanced features like 'AI slop' detection and LSP-enhanced semantic verification, it ensures that your technical documentation remains grounded, professional, and free from redundant bloat or vague marketing language.

主な機能

01AI 'slop' detection to identify and remediate generic AI-generated filler

02LSP-enhanced accuracy verification for API signatures and documentation coverage

03Automatic synchronization between plugin manifests and capability references

04Consolidation logic to detect and reduce documentation bloat and redundancy

050 GitHub stars

06Automated context collection from git history and changelog deltas

ユースケース

01Updating technical wikis and reference guides after major code refactors

02Maintaining immutable Architecture Decision Records (ADRs) within the project lifecycle

03Auditing documentation for technical accuracy and professional tone using automated style gates

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add micsapp/micstec-skills doc-updates

For use in Claude.ai and ChatGPT