How does the skill gather context for documentation updates?

It uses a bundled Bash script to collect branch info, archived tickets, file system structure, and git diff stats against the base branch.

Does this skill handle internationalization?

Yes, it specifically manages Japanese translations (_ja.md) and ensures that README files are mirrored across languages.

Can I use this for both developer and user documentation?

Absolutely. It distinguishes between developer specs in the .workaholic/specs/ directory and user guides in the .workaholic/guides/ directory.

What are the eight architectural viewpoints supported by this skill?

The skill manages documentation for stakeholder, model, usecase, infrastructure, application, component, data, and feature viewpoints.

What are the formatting requirements for spec files?

Every spec must include specific YAML frontmatter, use full-paragraph prose instead of bullets, and include at least two inline Mermaid diagrams.

Workaholic Spec Writer

Name: Workaholic Spec Writer
Author: qmu

byqmu

0•

学习与文档

Automates the creation and maintenance of viewpoint-based architecture specifications and technical user guides.

The write-spec skill provides a standardized framework for documenting complex software systems using a viewpoint-based architecture. It streamlines the documentation lifecycle by automatically gathering context from git diffs, tickets, and file structures via a dedicated Bash script. By enforcing consistency across eight specific architectural viewpoints—including stakeholder, model, and infrastructure—the skill ensures that documentation remains a 'living' reflection of the current codebase. It features robust support for internationalization (Japanese mirroring), automated frontmatter management, and integrated Mermaid diagramming to provide clear, professional documentation for both developers and end-users.

主要功能

010 GitHub stars

02Support for eight standardized architectural viewpoints (Stakeholder, Data, Model, etc.)

03Automated frontmatter management including ISO timestamps and commit hashes

04Standardized Mermaid diagram embedding and directory structure enforcement

05Automated context gathering from git history and archived tickets

06Integrated i18n support with automated English-to-Japanese document mirroring

使用场景

01Maintaining dual-language developer guides and READMEs within the .workaholic directory

02Synchronizing technical specifications with the latest code changes after a feature merge

03Generating comprehensive architectural documentation for new contributors using viewpoint-based templates

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add qmu/workaholic write-spec

For use in Claude.ai and ChatGPT

Download Skill