mirror of
https://github.com/github/awesome-copilot.git
synced 2026-04-16 13:15:56 +00:00
fix: update plugin description and remove readme installation instructions (#1399)
* fix: update plugin description * copilot suggestions
This commit is contained in:
Alishahzad1903
GitHub
2
.github/plugin/marketplace.json
vendored
2
.github/plugin/marketplace.json
vendored
@@ -80,7 +80,7 @@
|
||||
{
|
||||
"name": "context-matic",
|
||||
"source": "context-matic",
|
||||
"description": "General-purpose AI models are trained on public code and documentation, much of it outdated. They have no awareness of an actual API version, latest SDKs, or recommended workflows. ContextMatic gives GitHub Copilot deterministic, version-aware API context generated directly from API definitions and SDKs. Instead of guessing from public examples, the agent is grounded in current SDK versions, idiomatic code samples, and recommended integration workflows.",
|
||||
"description": "ContextMatic turns your AI agents from API-guessers into API-experts. By feeding agents exact, version-aware SDK methods and typed models for providers like PayPal, Spotify, and Twilio, ContextMatic replaces guesswork and outdated training data with high-fidelity ground truth. This eliminates hallucinations and broken code, ensuring surgical accuracy across 7+ languages so your agents build with precision instead of wasting tokens on trial and error.",
|
||||
"version": "0.1.0"
|
||||
},
|
||||
{
|
||||
|
||||
@@ -32,7 +32,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how t
|
||||
| [cast-imaging](../plugins/cast-imaging/README.md) | A comprehensive collection of specialized agents for software analysis, impact assessment, structural quality advisories, and architectural review using CAST Imaging. | 3 items | cast-imaging, software-analysis, architecture, quality, impact-analysis, devops |
|
||||
| [clojure-interactive-programming](../plugins/clojure-interactive-programming/README.md) | Tools for REPL-first Clojure workflows featuring Clojure instructions, the interactive programming chat mode and supporting guidance. | 2 items | clojure, repl, interactive-programming |
|
||||
| [context-engineering](../plugins/context-engineering/README.md) | Tools and techniques for maximizing GitHub Copilot effectiveness through better context management. Includes guidelines for structuring code, an agent for planning multi-file changes, and prompts for context-aware development. | 4 items | context, productivity, refactoring, best-practices, architecture |
|
||||
| [context-matic](../plugins/context-matic/README.md) | General-purpose AI models are trained on public code and documentation, much of it outdated. They have no awareness of an actual API version, latest SDKs, or recommended workflows. ContextMatic gives GitHub Copilot deterministic, version-aware API context generated directly from API definitions and SDKs. Instead of guessing from public examples, the agent is grounded in current SDK versions, idiomatic code samples, and recommended integration workflows. | 2 items | api-context, api-integration, mcp, sdk, apimatic, third-party-apis, sdks |
|
||||
| [context-matic](../plugins/context-matic/README.md) | ContextMatic turns your AI agents from API-guessers into API-experts. By feeding agents exact, version-aware SDK methods and typed models for providers like PayPal, Spotify, and Twilio, ContextMatic replaces guesswork and outdated training data with high-fidelity ground truth. This eliminates hallucinations and broken code, ensuring surgical accuracy across 7+ languages so your agents build with precision instead of wasting tokens on trial and error. | 2 items | api-context, api-integration, mcp, sdk, apimatic, third-party-apis, sdks |
|
||||
| [copilot-sdk](../plugins/copilot-sdk/README.md) | Build applications with the GitHub Copilot SDK across multiple programming languages. Includes comprehensive instructions for C#, Go, Node.js/TypeScript, and Python to help you create AI-powered applications. | 1 items | copilot-sdk, sdk, csharp, go, nodejs, typescript, python, ai, github-copilot |
|
||||
| [csharp-dotnet-development](../plugins/csharp-dotnet-development/README.md) | Essential prompts, instructions, and chat modes for C# and .NET development including testing, documentation, and best practices. | 9 items | csharp, dotnet, aspnet, testing |
|
||||
| [csharp-mcp-development](../plugins/csharp-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in C# using the official SDK. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 2 items | csharp, mcp, model-context-protocol, dotnet, server-development |
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "context-matic",
|
||||
"description": "General-purpose AI models are trained on public code and documentation, much of it outdated. They have no awareness of an actual API version, latest SDKs, or recommended workflows. ContextMatic gives GitHub Copilot deterministic, version-aware API context generated directly from API definitions and SDKs. Instead of guessing from public examples, the agent is grounded in current SDK versions, idiomatic code samples, and recommended integration workflows.",
|
||||
"description": "ContextMatic turns your AI agents from API-guessers into API-experts. By feeding agents exact, version-aware SDK methods and typed models for providers like PayPal, Spotify, and Twilio, ContextMatic replaces guesswork and outdated training data with high-fidelity ground truth. This eliminates hallucinations and broken code, ensuring surgical accuracy across 7+ languages so your agents build with precision instead of wasting tokens on trial and error.",
|
||||
"version": "0.1.0",
|
||||
"keywords": [
|
||||
"api-context",
|
||||
|
||||
@@ -4,24 +4,18 @@ Coding agents hallucinate APIs. APIMatic Context gives them curated, versioned A
|
||||
|
||||
When a developer asks their agent to "integrate the payments API," it normally guesses, pulling from outdated training data or generic patterns that don't match the actual SDK. ContextMatic solves this by giving the agent authoritative, version-aware, SDK-native context at the exact moment it's needed.
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
copilot plugin install context-matic@awesome-copilot
|
||||
```
|
||||
|
||||
## What It Includes
|
||||
|
||||
### MCP Server
|
||||
|
||||
| Server | Description |
|
||||
|--------|-------------|
|
||||
| --------------- | ---------------------------------------------------------------------------------- |
|
||||
| `context-matic` | Hosted MCP server for version-aware third-party API integration and SDK discovery. |
|
||||
|
||||
### Skills
|
||||
|
||||
| Skill | Description |
|
||||
|-------|-------------|
|
||||
| -------------------------- | ------------------------------------------------------------------------------------------------------------- |
|
||||
| `/integrate-context-matic` | Focused workflow for integrating supported third-party APIs using authoritative SDK and endpoint information. |
|
||||
| `/onboard-context-matic` | Guided walkthrough of the ContextMatic MCP server, supported APIs, and tool usage. |
|
||||
|
||||
@@ -33,12 +27,13 @@ ContextMatic gives GitHub Copilot version-aware API and SDK guidance grounded in
|
||||
- Authentication and quickstart guidance
|
||||
- Endpoint lookup with parameter and response details
|
||||
- Model lookup with typed property definitions
|
||||
|
||||
## Supported APIs
|
||||
|
||||
The plugin gives the agent SDK-native context for the following APIs, available in TypeScript, C#, Python, Java, PHP, and Ruby:
|
||||
|
||||
| API | Description |
|
||||
|-----|-------------|
|
||||
| ------------------------------ | ----------------------------------------------------------------------------------------- |
|
||||
| **Adyen API** | Payment processing: retrieve payment methods, create orders, manage stored payment tokens |
|
||||
| **Google Maps APIs** | Location services: geocoding, directions, distance matrix, elevation, roads, and places |
|
||||
| **PayPal Server SDK** | Payment flows: orders, payments, vault, transaction search, and subscriptions |
|
||||
@@ -58,7 +53,7 @@ This list is growing. [Suggest a new API](#contributing) to request support for
|
||||
Once installed, the plugin exposes seven tools to the agent. Each tool is mapped to a specific stage of the integration workflow:
|
||||
|
||||
| Tool | Developer task it enables |
|
||||
|------|--------------------------|
|
||||
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `fetch_api` | Lists all available APIs with their name, key, and description. The agent calls this first to discover which APIs are available for your project's language. |
|
||||
| `ask` | Chat with API Copilot for step-by-step integration guidance and general API questions: authentication setup, client initialization, feature behavior, framework-specific patterns (e.g. "How do I initialize the Twilio client in Laravel?"), and idiomatic SDK code samples. |
|
||||
| `endpoint_search` | Returns an SDK endpoint method's description, input parameters, and response shape by method name. |
|
||||
@@ -78,7 +73,7 @@ The seven tools are designed to chain together in a natural integration workflow
|
||||
**Your prompt:** _"/integrate-context-matic Add Twilio SMS notifications to my Next.js app. Send a text when an order ships."_
|
||||
|
||||
| Step | Tool called | What it returns |
|
||||
|------|-------------|----------------|
|
||||
| ---- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| 1 | `add_guidelines` (`language=typescript`) | Adds project guideline files the agent can follow for security, testing, and implementation workflow before starting the API integration. |
|
||||
| 2 | `add_skills` (`language=typescript`) | Adds reusable language-specific skills such as conventions guidance so the project setup matches future integration work. |
|
||||
| 3 | `fetch_api` (`language=typescript`) | Discovers Twilio is available; returns its `key` |
|
||||
@@ -90,7 +85,6 @@ The seven tools are designed to chain together in a natural integration workflow
|
||||
|
||||
Each step completes in a single tool call. The agent handles the orchestration. You describe the goal, and it picks the right tool at the right time.
|
||||
|
||||
|
||||
## MCP Server
|
||||
|
||||
This plugin uses the ContextMatic MCP endpoint:
|
||||
@@ -138,7 +132,7 @@ Transaction Search or Vault. Make it deployable with npm install and npm start.
|
||||
**How the tools were used:**
|
||||
|
||||
| Step | Tool | Query | What it returned |
|
||||
|------|------|-------|-----------------|
|
||||
| ---- | ----------------- | --------------------------------- | -------------------------------------------------------------------------------------------------- |
|
||||
| 1 | `fetch_api` | `language=typescript` | Available APIs; identified PayPal Server SDK with key `paypal` |
|
||||
| 2 | `ask` | SDK setup & environment switching | Client initialization code, `.env` structure, sandbox vs. live config via `Client.fromEnvironment` |
|
||||
| 3 | `ask` | Order creation flow | End-to-end create → approve → capture flow with full TypeScript server-side code |
|
||||
@@ -191,7 +185,7 @@ logos anywhere.
|
||||
**How the tools were used:**
|
||||
|
||||
| Step | Tool | Query | What it returned |
|
||||
|------|------|-------|-----------------|
|
||||
| ---- | ----------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| 1 | `fetch_api` | `language=python` | Available APIs; identified Spotify Web API SDK with key `spotify` |
|
||||
| 2 | `ask` | SDK setup, OAuth 2.0 authorization code flow for user login | Full `pip install spotify-api-sdk` setup, `SpotifywebapiClient` initialization with `AuthorizationCodeAuthCredentials`, `.env` structure, `get_authorization_url()` → `fetch_token(code)` → `clone_with(o_auth_token=token)` flow, token refresh pattern |
|
||||
| 3 | `ask` | How to fetch a user's top artists and top tracks | End-to-end code using `users_controller.get_users_top_artists()` and `users_controller.get_users_top_tracks()` with `time_range`, `limit`, `offset` params; reading `PagingArtistObject.items` and `PagingTrackObject.items` |
|
||||
@@ -237,7 +231,6 @@ logos anywhere.
|
||||
|
||||
|
||||
|
||||
|
||||
**What was built:** A PHP web app where users drop a pin (or use their location) on a Google Map, draw a travel-radius circle, and click "Spin" to randomly pick a restaurant within that radius. The app shows Google Places photos, a Street View storefront preview, and one-click directions — with a wheel animation and a "Spin Again" button for gamified suspense. Custom branding; credentials via `.env` file.
|
||||
|
||||
**The prompt:**
|
||||
@@ -255,7 +248,7 @@ animation and suspense make it feel like a game.
|
||||
**How the tools were used:**
|
||||
|
||||
| Step | Tool | Query | What it returned |
|
||||
|------|------|-------|-----------------|
|
||||
| ---- | ----------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| 1 | `fetch_api` | `language=php` | Available APIs; identified Google Maps Platform SDK with key `googlemaps` (also: `paypal`, `spotify`, `maxio`, `verizon`) |
|
||||
| 2 | `ask` | SDK setup, API key auth configuration | `composer require sdksio/google-maps-platform-sdk:1.0.3`, `GoogleMapsPlatformClientBuilder::init()` with `CustomQueryAuthenticationCredentialsBuilder::init('key')`, `.env` structure, `Environment::PRODUCTION` |
|
||||
| 3 | `ask` | How to search for nearby restaurants within a radius | Full code using `$client->getPlacesApi()->nearbySearch($location, $radius, 'restaurant', ...)`, response handling via `isSuccess()` / `getResult()`, iterating `Place[]` results |
|
||||
@@ -303,6 +296,7 @@ The best way to experience ContextMatic is to paste these prompts directly into
|
||||
<summary><strong>Quickstart: your first API call</strong></summary>
|
||||
|
||||
 
|
||||
|
||||
```
|
||||
/integrate-context-matic Set up the Spotify TypeScript SDK and fetch my top 5 tracks.
|
||||
Show me the complete client initialization and the API call.
|
||||
@@ -311,6 +305,7 @@ Show me the complete client initialization and the API call.
|
||||
---
|
||||
|
||||
 
|
||||
|
||||
```
|
||||
/integrate-context-matic How do I authenticate with the Twilio API and send an SMS?
|
||||
Give me the full PHP setup including the SDK client and the send call.
|
||||
@@ -319,6 +314,7 @@ Give me the full PHP setup including the SDK client and the send call.
|
||||
---
|
||||
|
||||
 
|
||||
|
||||
```
|
||||
/integrate-context-matic Walk me through initializing the Slack API client
|
||||
in a Python script and posting a message to a channel.
|
||||
@@ -330,6 +326,7 @@ in a Python script and posting a message to a channel.
|
||||
<summary><strong>Framework-specific integration</strong></summary>
|
||||
|
||||
  
|
||||
|
||||
```
|
||||
/integrate-context-matic I'm building a Next.js app. Integrate the Google Maps
|
||||
Places API to search for nearby restaurants and display them on a page.
|
||||
@@ -339,6 +336,7 @@ Use the TypeScript SDK.
|
||||
---
|
||||
|
||||
  
|
||||
|
||||
```
|
||||
/integrate-context-matic I'm using Laravel. Show me how to send a Twilio SMS
|
||||
when a user registers. Include the PHP SDK setup, client initialization, and the
|
||||
@@ -348,6 +346,7 @@ controller code.
|
||||
---
|
||||
|
||||
  
|
||||
|
||||
```
|
||||
/integrate-context-matic I have an ASP.NET Core app. Add Twilio webhook handling
|
||||
so I can receive delivery status callbacks when an SMS is sent.
|
||||
@@ -361,6 +360,7 @@ so I can receive delivery status callbacks when an SMS is sent.
|
||||
These prompts are designed to exercise the full plugin workflow; from API discovery through endpoint lookup to production-ready code.
|
||||
|
||||
  
|
||||
|
||||
```
|
||||
/integrate-context-matic I want to add real-time order shipping notifications
|
||||
to my Next.js store. Use Twilio to send an SMS when the order status changes to
|
||||
@@ -371,6 +371,7 @@ parameters, and the TypeScript code.
|
||||
---
|
||||
|
||||
  
|
||||
|
||||
```
|
||||
/integrate-context-matic I need to post a Slack message every time a Spotify
|
||||
track changes in my playlist monitoring app. Walk me through integrating both APIs
|
||||
@@ -381,6 +382,7 @@ and the exact API calls.
|
||||
---
|
||||
|
||||
  
|
||||
|
||||
```
|
||||
/integrate-context-matic In my ASP.NET Core app, I want to geocode user
|
||||
addresses using Google Maps and cache the results. Look up the geocode endpoint
|
||||
@@ -393,6 +395,7 @@ and response model, then generate the C# code including error handling.
|
||||
<summary><strong>Debugging and error handling</strong></summary>
|
||||
|
||||
 
|
||||
|
||||
```
|
||||
/integrate-context-matic My Spotify API call is returning 401. What OAuth flow
|
||||
should I be using and how does the TypeScript SDK handle token refresh automatically?
|
||||
@@ -401,6 +404,7 @@ should I be using and how does the TypeScript SDK handle token refresh automatic
|
||||
---
|
||||
|
||||
 
|
||||
|
||||
```
|
||||
/integrate-context-matic My Slack message posts are failing intermittently
|
||||
with rate limit errors. How does the Python SDK expose rate limit information and
|
||||
@@ -426,6 +430,7 @@ what's the recommended retry pattern?
|
||||
APIMatic takes your OpenAPI specification through the same SDK generation pipeline it uses to produce idiomatic, type-safe SDKs in 10+ languages. The resulting MCP server exposes the SDK documentation and integration patterns as structured tool responses that AI assistants can consume natively.
|
||||
|
||||
This means the context the AI receives is:
|
||||
|
||||
- Derived from actual generated SDK code, not raw documentation
|
||||
- Inclusive of idiomatic patterns, typed models, and error handling
|
||||
- Aligned to the current version of your API spec
|
||||
|
||||
Reference in New Issue
Block a user