write-spec

Enforce frontmatter and content structure for spec documentation updates.

1|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/qmu/workaholic --skill write-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-spec
Source: https://github.com/qmu/workaholic/tree/main/plugins/core/skills/write-spec
Command: npx skills add https://github.com/qmu/workaholic --skill write-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill standardizes spec documentation updates by enforcing a consistent frontmatter and content structure.

Core Features & Use Cases

  • Guidance for creating and updating documents under .workaholic/specs/
  • Enforces frontmatter, content style, and cross-cutting documentation practices
  • Supports a gather workflow to provide context for changes

Quick Start

Run the bundled script to collect context for a spec update: bash .claude/skills/write-spec/sh/gather.sh [base-branch]

Frequently Asked Questions about write-spec

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

FAQPage Schema
How do I standardize frontmatter for spec documentation?

Standardize spec documentation by enforcing required frontmatter fields including title, description, modified_at, and commit_hash. This maintains consistent content structure across guides and terms for reliable AI-driven changes.

What is the gather workflow for collecting change context?

The gather workflow uses a bundled bash script, gather.sh, to collect relevant change context for spec updates. Executing it against a base branch provides necessary background for modifying documentation.

How do I update documents under .workaholic/specs?

Update documents under .workaholic/specs by applying consistent frontmatter and content style guidelines. This enforces cross-cutting documentation practices and maintains reliable context for modifications.

Do I need bash to run the spec context gathering script?

Yes, a bash environment is required to execute the gather.sh script. This script collects change context from a specified base branch to support your spec documentation workflow.

What are the required frontmatter fields for specs?

Required frontmatter fields for specs include title, description, modified_at, and commit_hash. Enforcing these fields standardizes documents and provides reliable context for AI-driven changes.