skills.rest
yongwoon
yongwoonCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

ywc-spec-writer

Generate and incrementally update Markdown project specifications from code changes.

8|1|Updated May 13, 2026
Search Tags:#automation#project management#developer tools#documentation#markdown#specification
One-click install
npx skills add https://github.com/yongwoon/ywc-agent-toolkit --skill ywc-spec-writer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ywc-spec-writer
Source: https://github.com/yongwoon/ywc-agent-toolkit/tree/main/claude-code/skills/ywc-spec-writer
Command: npx skills add https://github.com/yongwoon/ywc-agent-toolkit --skill ywc-spec-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, python3, git, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the problem of documentation drift by automating the creation and maintenance of project specifications, ensuring that technical intent remains synchronized with code changes without requiring manual updates.

Core Features & Use Cases

  • Incremental Updates: Automatically update specific sections of your specification based on PR diffs, commit history, or specific task directories.
  • Full Generation: Generate a complete, 7-section project specification from scratch, including overview, features, data models, and non-functional requirements.
  • Use Case: When a developer completes a set of tasks, they can use this Skill to reflect the new features and data model changes directly into the canonical documentation, ensuring stakeholders always have an accurate view of the project.

Quick Start

Use the ywc-spec-writer skill to update the project specification based on the changes in the current commit.

Frequently Asked Questions about ywc-spec-writer

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

FAQPage Schema
How do I automate project specification updates from pull requests?▼

Automate project specification updates by applying PR diffs to incrementally update specific Markdown sections, ensuring technical documentation stays synchronized with code changes without manual intervention.

Can I generate a full project specification in Markdown from scratch?▼

Yes, generate a complete project specification in Markdown from scratch, producing a 7-section document covering overview, features, data models, and non-functional requirements for your repository.

Do I need GitHub CLI to keep documentation synchronized with code changes?▼

Yes, GitHub CLI is required for PR-based updates, while the skill also uses python3, git, and jq to process commit history and task directories for incremental Markdown documentation maintenance.

What is the best way to maintain domain-driven design documentation?▼

Maintain domain-driven design documentation by enforcing ubiquitous language constraints within your specification files, automatically reflecting new features and data model changes as developers complete tasks.

Does this specification writer work with incremental commit history updates?▼

Yes, it supports incremental updates by reading commit history and task directory changes to reflect new features and data model updates directly into the canonical Markdown documentation.

Related Skills

Explore More Software Engineering Skills→
maveroxmaverox

pr-analysis

Parse GitHub pull request data and summarize metadata, diffs, and scope.

Community
Advanced
OnlyaguestOnlyaguest
18

data-showcase-site

Convert CSV, JSON, Markdown, or HTML data into a static report site.

Community
Intermediate
4lerman4lerman

senior-devops

Automates DevOps workflows including CI/CD pipelines, infrastructure as code, and container deployments with rollback support.

Community
Advanced
rochacbrunorochacbruno
866

marmite

Convert markdown files into complete static websites without manual configuration.

Community
Intermediate