skills.rest
wilsto
wilstoCOMMUNITY
Explore all skills by this author →
GitHub

spec-update

Update functional specifications and README files from conventional commits.

Updated Feb 26, 2026
Search Tags:#documentation#workflow automation#knowledge management#specifications#readme#code commit
One-click install
npx skills add https://github.com/wilsto/claude-code-starter-kit --skill spec-update-wilsto
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-update
Source: https://github.com/wilsto/claude-code-starter-kit/tree/main/.claude/skills/spec-update
Command: npx skills add https://github.com/wilsto/claude-code-starter-kit --skill spec-update-wilsto

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that your project's documentation, including functional specifications and README files, stays up-to-date with code changes, preventing documentation drift and improving project clarity.

Core Features & Use Cases

  • Automatic Spec Updates: Updates functional specs based on code commits (feat, fix, refactor).
  • README Synchronization: Proposes updates to README files if changes impact installation, configuration, or usage.
  • Lessons Learned Capture: Identifies and records valuable insights from code changes in memory files.
  • Initial Spec Bootstrapping: Scans the codebase to generate initial functional specifications for new projects.
  • Use Case: After adding a new payment gateway feature, this Skill automatically updates the payment functional spec with new user stories and ensures the README reflects any new configuration options.

Quick Start

Run the spec-update skill to bootstrap documentation for a new project.

Frequently Asked Questions about spec-update

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

FAQPage Schema
How do I keep functional specifications in sync with code changes?▼

Keeping specifications in sync involves parsing conventional commits like feat, fix, and refactor to automatically update functional specifications and README files, preventing documentation drift and improving project clarity.

Can I bootstrap documentation for a new project based on the existing codebase?▼

Bootstrapping documentation for a new project is supported by scanning the codebase to generate initial functional specifications, ensuring your new project has accurate and complete foundational docs from the start.

How do I automatically update a README file when configuration changes occur?▼

Updating a README file when configuration changes occur is handled by proposing updates to the README if code changes impact installation or usage, ensuring users always have accurate configuration instructions.

How do conventional commits help automate documentation updates?▼

Conventional commits help automate documentation updates by being parsed to determine the scope and type of changes, which then triggers accurate and complete updates to functional specifications and README files.

Does this tool capture lessons learned from code commits?▼

This tool does capture lessons learned from code commits by identifying and recording valuable insights from code changes in memory files, aiding in long-term project knowledge management.

Related Skills

Explore More Software Engineering Skills→
dudusoardudusoar

git-log

Generate Conventional Commits messages and update GIT_LOG.md documentation.

Community
Basic
MikkoNumminenMikkoNumminen

sync-readmes

Synchronize project metadata between portfolio registry and GitHub README files.

Community
Advanced
TabTabGoTabTabGo

expo-cicd-workflows

Generate, edit, and validate Expo EAS workflow YAML files against schema standards.

Official
Basic
xxihxxih
1

security-scan

Scan Claude project configuration files for security vulnerabilities.

Community
Advanced