update-specification

Update specification files with YAML front matter and Markdown structure.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/PoyoPoak/FastAPI-App-Template --skill update-specification-poyopoak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-specification
Source: https://github.com/PoyoPoak/FastAPI-App-Template/tree/main/.agents/skills/update-specification
Command: npx skills add https://github.com/PoyoPoak/FastAPI-App-Template --skill update-specification-poyopoak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps specifications up-to-date with evolving requirements and AI-friendly formatting.

Core Features & Use Cases

  • Automates updating the /spec/ file to reflect new requirements and changes.
  • Validates YAML frontmatter and Markdown sections for consistency with the template.
  • Generates a compliant Quick Start instruction for immediate execution by AI assistants.

Quick Start

Update the specification file to reflect the latest requirements and ensure the doc remains valid.

Frequently Asked Questions about update-specification

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

FAQPage Schema
How do I update a project specification to reflect new requirements?

To update a project specification, you modify the central file under the /spec/ directory to reflect new requirements. This process enforces consistent formatting, versioning, and clarity to ensure the document remains valid for AI assistants.

What is YAML frontmatter validation for Markdown specifications?

YAML frontmatter validation checks that your Markdown specification includes the required name and description fields. This ensures the central spec file maintains consistent formatting and remains machine-readable for AI-ready project workflows.

How do I maintain AI-ready docs when project requirements change?

Maintaining AI-ready docs involves automatically updating the specification file to reflect new requirements and changes. It validates the Markdown structure and YAML frontmatter to ensure the documentation is consistently formatted and immediately executable by AI.

Does specification validation work without external dependencies?

Yes, specification validation works without external dependencies. It independently enforces a YAML frontmatter with name and description fields and validates the Markdown body against a provided template to ensure consistent formatting.

What is the best way to version Markdown specs for AI assistants?

The best way to version Markdown specs for AI assistants is to maintain a central file under /spec/ with strict YAML frontmatter. This ensures consistent formatting, versioning, and clarity while generating a compliant Quick Start instruction for immediate execution.