Skip to content

Typespec create agent vs Typespec create API plugin

Typespec create agent is an open-source agent skill for developer tools. Typespec create API plugin is an open-source agent skill for developer tools.

  • Typespec create agent is best for create a typespec agent for an internal hr policy assistant.
  • Typespec create API plugin is best for wrap a company rest api as a microsoft 365 copilot plugin.
What it is
Typespec create agent is an open-source agent skill for developer tools.
Typespec create API plugin is an open-source agent skill for developer tools.
Best for
Create a TypeSpec agent for an internal HR policy assistant
Wrap a company REST API as a Microsoft 365 Copilot plugin
Kind
Skill
Skill
Pricing
Open source
Open source
Platforms
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
GitHub stars
41.3K
41.3K
Last commit
Nov 2026
Nov 2026
License
MIT
MIT
Open source
Good for
Create a TypeSpec agent for an internal HR policy assistant; Define a Copilot agent that searches a company SharePoint site; Generate a research helper agent with web search and conversation starters
Wrap a company REST API as a Microsoft 365 Copilot plugin; Create a TypeSpec agent that lists and creates tickets in an external system; Add an OAuth2-protected API to a Copilot agent

What Typespec create agent does

  • Agent declaration

    Produces the agent name and description within the documented length limits.

  • Behavioral instructions

    Drafts role, expertise and scope guidance for the agent in a multi-line instructions block.

  • Conversation starters

    Adds two to four diverse starter prompts that showcase different capabilities.

  • Capability selection

    Chooses from the supported Microsoft 365 Copilot capabilities based on what the agent needs.

  • Scoped access

    Recommends limiting URLs, folders and sources to improve agent performance.

  • TypeSpec template

    Follows a standard main.tsp structure with the required imports and namespace.

What Typespec create API plugin does

  • Agent definition scaffold

    Provides a main.tsp template that declares the agent name, description and instructions and imports operations from an actions file.

  • REST operation mapping

    Shows how to declare routes, HTTP verbs and typed parameters for each external API operation.

  • Authentication options

    Covers no auth, API key, OAuth2 authorization code and registered auth references for the plugin.

  • Confirmation dialogs

    Describes an Adaptive Card confirmation step for operations such as deletes or critical updates.

  • Adaptive Card responses

    Explains binding response data to a card template with title, URL and data path mappings.

  • Guided setup questions

    Lists the questions the agent should ask about the API before generating the TypeSpec files.

Typespec create agent vs Typespec create API plugin: questions

Is Typespec create agent or Typespec create API plugin cheaper?

Both are open source. Compare current plans on each official site.

What is the difference between Typespec create agent and Typespec create API plugin?

Typespec create agent is an open-source agent skill for developer tools. Typespec create API plugin is an open-source agent skill for developer tools.

Keep comparing