github avatar

Create Specification

The create-specification skill generates structured specification files optimized for AI consumption, helping development teams document requirements, constraints, and interfaces in a machine-readable format. It serves software architects, developers, and AI systems that need clear, unambiguous technical specifications by providing a standardized template and best practices that ensure specifications are precise, self-contained, and easy for both humans and generative AI to parse. This skill solves the problem of creating AI-ready documentation that minimizes ambiguity and improves the quality of AI-generated code by establishing explicit requirements and technical contracts upfront.

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

Install

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

Installs into .claude/skills of the current project.

Files

Create Specification

Your goal is to create a new specification file for ${input:SpecPurpose}.

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 avatargame-enginegithub/awesome-copilotExpert skill for building web-based game engines and games using HTML5, Canvas, WebGL, and JavaScript. Use when asked to create games, build game engines, imple13.4Kskills.sh installs
2github avatarrefactor-plangithub/awesome-copilotCreate a concrete plan before starting a multi-file refactor. Use when the user asks to plan, sequence, scope, or safely execute a refactor across multiple file13Kskills.sh installs
3github avatarpytest-coveragegithub/awesome-copilotRun pytest tests with coverage, discover lines missing coverage, and increase coverage to 100%.13Kskills.sh installs
4github avatarpenpot-uiux-designgithub/awesome-copilotComprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or d12.9Kskills.sh installs
5github avatarmemory-mergergithub/awesome-copilotMerges mature lessons from a domain memory file into its instruction file. Syntax: `/memory-merger >domain [scope]` where scope is `global` (default), `user`, `12.9Kskills.sh installs
6github avatarcreate-implementation-plangithub/awesome-copilotCreate a new implementation plan file for new features, refactoring existing code or upgrading packages, design, architecture or infrastructure.12.6Kskills.sh installs