How does this skill prevent documentation rot?

It enforces a systematic update procedure for specification files whenever screens, features, or permissions are modified, ensuring the docs reflect the current state of the code.

Does it track UI and permission changes?

Absolutely. The workflow specifically includes steps to update screen URLs, navigation flows, and access permissions in the central specification docs.

Which specific documentation files does this skill manage?

It targets files within the docs/spec/ directory, specifically screens.md, user-app.md, admin.md, and acceptance.md.

Can this skill help with testing preparation?

Yes, by keeping the acceptance.md (acceptance criteria) file updated, it ensures that your testing and QA phases are based on the most recent functional requirements.

Spec Maintenance

Name: Spec Maintenance
Author: knomura03

byknomura03

0•

학습 및 문서화

Automates the synchronization of technical specifications and acceptance criteria with implementation changes to prevent documentation rot.

The Spec Maintenance skill ensures that your project documentation remains a single source of truth by providing a structured workflow for updating screen lists, functional requirements, and permission settings. It prevents the common problem of documentation diverging from implementation by guiding users through a rigorous multi-step process to update specific markdown files in the docs/spec directory whenever features, UI elements, or user permissions are modified. This skill is essential for teams that rely on up-to-date documentation for testing, auditing, and seamless developer handoffs.

주요 기능

01Updates functional requirements for both user-facing and admin applications

02Identifies impacted system components and logic flow changes for precise updates

03Synchronizes screen lists with the latest URLs, purpose, and permission requirements

04Audits the project README to ensure the documentation index is always current

05Maintains up-to-date acceptance criteria to ensure testing alignment with features

060 GitHub stars

사용 사례

01Synchronizing permission settings across admin and user documentation after a security audit

02Refining acceptance criteria during development iterations to match implementation

03Updating technical specs after adding new features or UI screens to the application

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add knomura03/teppenmeo spec-maintenance

For use in Claude.ai and ChatGPT

Download Skill