From 2ab1df211bf959ebd8eaf7e24ad01e2e8a6f8212 Mon Sep 17 00:00:00 2001 From: Yaron Reichert Date: Thu, 12 Mar 2026 14:24:05 +0200 Subject: [PATCH] improve: fix docs skill title, clarify mcp.json placeholders, add install steps to README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Three usability issues identified during plugin testing: 1. cloudinary-docs/SKILL.md had a "# My Skill" placeholder title left over from the skill template — replaced with the correct title. 2. mcp.json credential placeholders ("cloud_name", "api_key", "api_secret") looked like real values rather than placeholders. Renamed to "YOUR_CLOUD_NAME" / "YOUR_API_KEY" / "YOUR_API_SECRET" to make it obvious these must be replaced. 3. README "Getting Started" step 1 said "Install this plugin in Cursor/Claude Code" with no instructions on how. Added step-by-step installation instructions for both Cursor and Claude Code, plus five example prompts to help users get started quickly. Made-with: Cursor --- README.md | 26 +++++++++++++++++++++++--- mcp.json | 6 +++--- skills/cloudinary-docs/SKILL.md | 4 ++-- 3 files changed, 28 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 4f2d7e9..6b32874 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,26 @@ Two skills are included to give the agent deep Cloudinary knowledge: ## Getting Started -1. Install this plugin in Cursor/Claude Code. -2. On first use, approve the OAuth login prompt for the MCP servers. For `cloudinary-mediaflows`, add your credentials to its headers in `mcp.json`. -3. Ask your agent anything about Cloudinary — uploads, transformations, metadata, analysis, and more. The agent will automatically use the right skill and MCP server for the job. +### Cursor + +1. Copy the contents of `mcp.json` into your project's `.cursor/mcp.json` (create the file if it doesn't exist). +2. Copy the `skills/` directory into your project root. +3. In `.cursor/rules/`, create one rule file per skill — each pointing to its `SKILL.md`. Cursor will use the rule description to decide when to invoke the skill. +4. For `cloudinary-mediaflows`, replace `YOUR_CLOUD_NAME`, `YOUR_API_KEY`, and `YOUR_API_SECRET` in `mcp.json` with your Cloudinary credentials (found in the [Cloudinary Console](https://console.cloudinary.com/settings/api-keys)). +5. On first use, approve the OAuth login prompt that Cursor shows for the other four MCP servers. + +### Claude Code + +1. Run: `claude --plugin-dir /path/to/cloudinary-plugin` +2. For `cloudinary-mediaflows`, replace the credential placeholders in `mcp.json` before starting. +3. On first use, complete the OAuth login for the other four MCP servers. + +Once installed, ask your agent anything about Cloudinary — uploads, transformations, metadata, analysis, and more. The agent will automatically use the right skill and MCP server for the job. + +### Example prompts + +- "Upload this image to my Cloudinary account and resize it to 800px wide: [URL]" +- "Remove the background from my product photo and replace it with a white padded square at 1000x1000" +- "Debug this Cloudinary URL — it's not cropping correctly: [URL]" +- "How do I set up the Cloudinary Node.js SDK in my Express app?" +- "List all images in my account uploaded in the last 7 days" diff --git a/mcp.json b/mcp.json index 309ad3c..8f19b0e 100644 --- a/mcp.json +++ b/mcp.json @@ -15,9 +15,9 @@ "cloudinary-mediaflows": { "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp", "headers": { - "cld-cloud-name": "cloud_name", - "cld-api-key": "api_key", - "cld-secret": "api_secret" + "cld-cloud-name": "YOUR_CLOUD_NAME", + "cld-api-key": "YOUR_API_KEY", + "cld-secret": "YOUR_API_SECRET" } } } diff --git a/skills/cloudinary-docs/SKILL.md b/skills/cloudinary-docs/SKILL.md index 1e0eeaf..3a82199 100644 --- a/skills/cloudinary-docs/SKILL.md +++ b/skills/cloudinary-docs/SKILL.md @@ -3,9 +3,9 @@ name: cloudinary-docs description: This skill is used to look up how to do something in Cloudinary using the Cloudinary LLMs.txt and the sanitized markdown files. --- -# My Skill +# Cloudinary Documentation Skill -Helps developers to integrate Cloudinary into their applications by providing documentation and code examples retrieved directly from the optimized .md files in the Cloudinary documentation rather than having parse the HTML pages. +Helps developers integrate Cloudinary into their applications by providing documentation and code examples retrieved directly from the optimized .md files in the Cloudinary documentation, rather than having to parse HTML pages. ## When to Use