create-specification

Developer Tools

Gives your agent the ability to define clear, unambiguous, and AI-ready specifications for schemas, tools, architecture, and more, ensuring a machine-readable project foundation.

When to use

When you need to define requirements and data contracts for a new system component
When you want to create a specification optimized for consumption by Generative AI
When you need to document architectural dependencies and acceptance criteria in a standard way

How to use

1
Identify the purpose of your spec, such as schema, tool, or infrastructure
2
Define the core requirements, constraints, and guidelines using precise language
3
Outline the interfaces, data contracts, and specific acceptance criteria (Given-When-Then)
4
Review and save the formatted spec file to your project's /spec/ directory

Example conversation

case

You

Create a technical spec for our new analytics tool.

Agent

I'll generate spec-tool-analytics.md in your /spec/ directory. I'll define clear REQ- codes for every requirement, set up data contracts for your event schemas, and include testable acceptance criteria so both humans and AI can verify the implementation.

FAQ

Related Skills

update-specificationContent & Writing

Gives your agent the ability to update technical specifications for requirements, constraints, and data contracts optimized for AI consumption.

create-github-pull-request-from-specificationDeveloper Tools

Gives your agent the ability to automatically draft and manage a GitHub Pull Request based on a specification template, ensuring all project requirements are met.

create-github-issue-feature-from-specificationDeveloper Tools

Gives your agent the ability to transform a technical specification file into a clear, structured GitHub Issue for a complete feature request.

create-github-issues-for-unmet-specification-requirementsDeveloper Tools

Gives your agent the ability to audit your codebase against a specification and automatically create GitHub Issues for any unimplemented requirements it finds.

typespec-create-agentDeveloper Tools

Gives your agent the ability to generate complete TypeSpec declarative agents with instructions and custom capabilities for Copilot.

create-specification

Developer Tools

Gives your agent the ability to define clear, unambiguous, and AI-ready specifications for schemas, tools, architecture, and more, ensuring a machine-readable project foundation.

When to use

When you need to define requirements and data contracts for a new system component
When you want to create a specification optimized for consumption by Generative AI
When you need to document architectural dependencies and acceptance criteria in a standard way

How to use

1
Identify the purpose of your spec, such as schema, tool, or infrastructure
2
Define the core requirements, constraints, and guidelines using precise language
3
Outline the interfaces, data contracts, and specific acceptance criteria (Given-When-Then)
4
Review and save the formatted spec file to your project's /spec/ directory

Example conversation

case

You

Create a technical spec for our new analytics tool.

Agent

FAQ

Related Skills

update-specificationContent & Writing

Gives your agent the ability to update technical specifications for requirements, constraints, and data contracts optimized for AI consumption.

create-github-pull-request-from-specificationDeveloper Tools

Gives your agent the ability to automatically draft and manage a GitHub Pull Request based on a specification template, ensuring all project requirements are met.

create-github-issue-feature-from-specificationDeveloper Tools

Gives your agent the ability to transform a technical specification file into a clear, structured GitHub Issue for a complete feature request.

create-github-issues-for-unmet-specification-requirementsDeveloper Tools

Gives your agent the ability to audit your codebase against a specification and automatically create GitHub Issues for any unimplemented requirements it finds.

typespec-create-agentDeveloper Tools

Gives your agent the ability to generate complete TypeSpec declarative agents with instructions and custom capabilities for Copilot.

Product

Community

create-specification

When to use

How to use

Example conversation

FAQ

Related Skills

Product

Community

create-specification

When to use

How to use

Example conversation

FAQ

Related Skills

Product

Community