github avatar

Update Specification

The update-specification skill enables developers and AI systems to revise existing specification files based on new requirements or code changes, ensuring documentation remains current and machine-readable. It's designed for teams using generative AI to maintain clear, structured specifications that follow established formatting standards and best practices for AI consumption. The skill solves the problem of keeping technical specifications synchronized with evolving codebases by providing templates and guidelines that produce unambiguous, self-contained documentation optimized for both human and machine interpretation.

skills.sh installs
9.2K
GitHub stars
41K
last updated
Aug 21, 2026

Install

$ npx -y skills add github/awesome-copilot --skill update-specification --agent claude-code

Installs into .claude/skills of the current project.

Files

Update Specification

Your goal is to update the existing specification file ${file} based on new requirements or updates to any existing code.

The specification file must define the requirements, constraints, and interfaces for the solution components in a manner that is clear, unambiguous, and structured for effective use by Generative AIs. Follow established documentation standards and ensure the content is machine-readable and self-contained.

Best Practices for AI-Ready Specifications

  • Use precise, explicit, and unambiguous language.
  • Clearly distinguish between requirements, constraints, and recommendations.
  • Use structured formatting (headings, lists, tables) for easy parsing.
  • Avoid idioms, metaphors, or context-dependent references.
  • Define all acronyms and domain-specific terms.
  • Include examples and edge cases where applicable.
  • Ensure the document is self-contained and does not rely on external context.

Sponsors

Details

Repository
github.com/github/awesome-copilot
Categories
Git & Pull Requests, AI & Agent Building

More from github/awesome-copilot

All 318
1github avatargo-mcp-server-generatorgithub/awesome-copilotGenerate a complete Go MCP server project with proper structure, dependencies, and implementation using the official github.com/modelcontextprotocol/go-sdk.9.2Kskills.sh installs
2github avatarrust-mcp-server-generatorgithub/awesome-copilotGenerate a complete Rust Model Context Protocol server project with tools, prompts, resources, and tests using the official rmcp SDK9.2Kskills.sh installs
3github avatarcreate-llmsgithub/awesome-copilotCreate an llms.txt file from scratch based on repository structure following the llms.txt specification at https://llmstxt.org/9.2Kskills.sh installs
4github avatarpower-bi-dax-optimizationgithub/awesome-copilotComprehensive Power BI DAX formula optimization prompt for improving performance, readability, and maintainability of DAX calculations.9.2Kskills.sh installs
5github avataraspnet-minimal-api-openapigithub/awesome-copilotCreate ASP.NET Minimal API endpoints with proper OpenAPI documentation9.2Kskills.sh installs
6github avatararch-linux-triagegithub/awesome-copilotTriage and resolve Arch Linux issues with pacman, systemd, and rolling-release best practices.9.1Kskills.sh installs