From ee2d61f8b9679a402afacda2a9b5e3152997ce0c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fatih=20Kadir=20Ak=C4=B1n?= Date: Fri, 16 Jan 2026 00:38:37 +0300 Subject: [PATCH] feat(claude-plugin): add prompts.chat marketplace and plugin structure --- .claude-plugin/marketplace.json | 29 +++ CLAUDE-PLUGIN.md | 166 ++++++++++++++++++ README.md | 14 ++ .../prompts.chat/.claude-plugin/plugin.json | 23 +++ plugins/claude/prompts.chat/.mcp.json | 6 + .../prompts.chat/agents/prompt-manager.md | 67 +++++++ .../prompts.chat/agents/skill-manager.md | 101 +++++++++++ .../claude/prompts.chat/commands/prompts.md | 66 +++++++ .../claude/prompts.chat/commands/skills.md | 74 ++++++++ .../skills/prompt-lookup/SKILL.md | 68 +++++++ .../prompts.chat/skills/skill-lookup/SKILL.md | 76 ++++++++ 11 files changed, 690 insertions(+) create mode 100644 .claude-plugin/marketplace.json create mode 100644 CLAUDE-PLUGIN.md create mode 100644 plugins/claude/prompts.chat/.claude-plugin/plugin.json create mode 100644 plugins/claude/prompts.chat/.mcp.json create mode 100644 plugins/claude/prompts.chat/agents/prompt-manager.md create mode 100644 plugins/claude/prompts.chat/agents/skill-manager.md create mode 100644 plugins/claude/prompts.chat/commands/prompts.md create mode 100644 plugins/claude/prompts.chat/commands/skills.md create mode 100644 plugins/claude/prompts.chat/skills/prompt-lookup/SKILL.md create mode 100644 plugins/claude/prompts.chat/skills/skill-lookup/SKILL.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 00000000..c9d905e4 --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,29 @@ +{ + "name": "prompts.chat", + "owner": { + "name": "Fatih Kadir Akın", + "email": "fatihkadirakin@gmail.com" + }, + "metadata": { + "description": "Official prompts.chat marketplace - AI prompts, skills, and tools for Claude Code", + "version": "1.0.0" + }, + "plugins": [ + { + "name": "prompts.chat", + "source": "./plugins/claude/prompts.chat", + "description": "Access thousands of AI prompts and skills directly in your AI coding assistant. Search prompts, discover skills, save your own, and improve prompts with AI.", + "version": "1.0.0", + "author": { + "name": "Fatih Kadir Akın", + "email": "fatihkadirakin@gmail.com" + }, + "homepage": "https://prompts.chat", + "repository": "https://github.com/f/awesome-chatgpt-prompts", + "license": "MIT", + "keywords": ["prompts", "ai", "skills", "chatgpt", "claude", "llm"], + "category": "ai", + "tags": ["prompts", "ai-tools", "productivity", "skills"] + } + ] +} diff --git a/CLAUDE-PLUGIN.md b/CLAUDE-PLUGIN.md new file mode 100644 index 00000000..b3041c55 --- /dev/null +++ b/CLAUDE-PLUGIN.md @@ -0,0 +1,166 @@ +# Claude Code Plugin + +Access prompts.chat directly in [Claude Code](https://code.claude.com) with our official plugin. Search prompts, discover skills, and improve your prompts without leaving your IDE. + +## Installation + +Add the prompts.chat marketplace to Claude Code: + +``` +/plugin marketplace add f/awesome-chatgpt-prompts +``` + +Then install the plugin: + +``` +/plugin install prompts.chat@prompts.chat +``` + +## Features + +| Feature | Description | +|---------|-------------| +| **MCP Server** | Connect to prompts.chat API for real-time prompt access | +| **Commands** | `/prompts.chat:prompts` and `/prompts.chat:skills` slash commands | +| **Agents** | Prompt Manager and Skill Manager agents for complex workflows | +| **Skills** | Auto-activating skills for prompt and skill discovery | + +## Commands + +### Search Prompts + +``` +/prompts.chat:prompts +/prompts.chat:prompts --type IMAGE +/prompts.chat:prompts --category coding +/prompts.chat:prompts --tag productivity +``` + +**Examples:** +``` +/prompts.chat:prompts code review +/prompts.chat:prompts writing assistant --category writing +/prompts.chat:prompts midjourney --type IMAGE +/prompts.chat:prompts react developer --tag coding +``` + +### Search Skills + +``` +/prompts.chat:skills +/prompts.chat:skills --category coding +/prompts.chat:skills --tag automation +``` + +**Examples:** +``` +/prompts.chat:skills testing automation +/prompts.chat:skills documentation --category coding +/prompts.chat:skills api integration +``` + +## MCP Tools + +The plugin provides these tools via the prompts.chat MCP server: + +### Prompt Tools + +| Tool | Description | +|------|-------------| +| `search_prompts` | Search prompts by keyword, category, tag, or type | +| `get_prompt` | Retrieve a prompt with variable substitution | +| `save_prompt` | Save a new prompt (requires API key) | +| `improve_prompt` | Enhance prompts using AI | + +### Skill Tools + +| Tool | Description | +|------|-------------| +| `search_skills` | Search for Agent Skills | +| `get_skill` | Get a skill with all its files | +| `save_skill` | Create multi-file skills (requires API key) | +| `add_file_to_skill` | Add a file to an existing skill | +| `update_skill_file` | Update a file in a skill | +| `remove_file_from_skill` | Remove a file from a skill | + +## Agents + +### Prompt Manager + +The `prompt-manager` agent helps you: +- Search for prompts across prompts.chat +- Get and fill prompt variables +- Save new prompts to your account +- Improve prompts using AI + +### Skill Manager + +The `skill-manager` agent helps you: +- Search for Agent Skills +- Get and install skills to your workspace +- Create new skills with multiple files +- Manage skill file contents + +## Skills (Auto-Activating) + +### Prompt Lookup + +Automatically activates when you: +- Ask for prompt templates +- Want to search for prompts +- Need to improve a prompt +- Mention prompts.chat + +### Skill Lookup + +Automatically activates when you: +- Ask for Agent Skills +- Want to extend Claude's capabilities +- Need to install a skill +- Mention skills for Claude + +## Authentication + +To save prompts and skills, you need an API key from [prompts.chat/settings](https://prompts.chat/settings). + +### Option 1: Environment Variable + +Set the `PROMPTS_API_KEY` environment variable: + +```bash +export PROMPTS_API_KEY=your_api_key_here +``` + +### Option 2: MCP Header + +Add the header when connecting to the MCP server: + +``` +PROMPTS_API_KEY: your_api_key_here +``` + +## Plugin Structure + +``` +plugins/claude/prompts.chat/ +├── .claude-plugin/ +│ └── plugin.json # Plugin manifest +├── .mcp.json # MCP server configuration +├── commands/ +│ ├── prompts.md # /prompts.chat:prompts command +│ └── skills.md # /prompts.chat:skills command +├── agents/ +│ ├── prompt-manager.md # Prompt management agent +│ └── skill-manager.md # Skill management agent +└── skills/ + ├── prompt-lookup/ + │ └── SKILL.md # Prompt discovery skill + └── skill-lookup/ + └── SKILL.md # Skill discovery skill +``` + +## Links + +- **[prompts.chat](https://prompts.chat)** - Browse all prompts and skills +- **[API Documentation](https://prompts.chat/api/mcp)** - MCP server endpoint +- **[Settings](https://prompts.chat/settings)** - Get your API key diff --git a/README.md b/README.md index 8428dc4b..bfa7597e 100644 --- a/README.md +++ b/README.md @@ -129,6 +129,20 @@ We hope you find these prompts useful and have fun exploring AI chat models! **[View on prompts.chat](https://prompts.chat)** **[View Hugging Face Dataset](https://huggingface.co/datasets/fka/awesome-chatgpt-prompts/)** + +--- + +## Claude Code Plugin + +Access prompts.chat directly in [Claude Code](https://code.claude.com) with our official plugin. + +``` +/plugin marketplace add f/awesome-chatgpt-prompts +/plugin install prompts.chat@prompts.chat +``` + +📖 **[View Full Plugin Documentation](CLAUDE-PLUGIN.md)** + --- > ℹ️ **NOTE:** Sometimes, some of the prompts may not be working as you expected diff --git a/plugins/claude/prompts.chat/.claude-plugin/plugin.json b/plugins/claude/prompts.chat/.claude-plugin/plugin.json new file mode 100644 index 00000000..9474a9c1 --- /dev/null +++ b/plugins/claude/prompts.chat/.claude-plugin/plugin.json @@ -0,0 +1,23 @@ +{ + "name": "prompts.chat", + "description": "Access thousands of AI prompts and skills directly in your AI coding assistant. Search prompts, discover skills, save your own, and improve prompts with AI.", + "version": "1.0.0", + "author": { + "name": "Fatih Kadir Akın", + "email": "fatihkadirakin@gmail.com" + }, + "homepage": "https://prompts.chat", + "repository": "https://github.com/f/awesome-chatgpt-prompts", + "license": "MIT", + "keywords": ["prompts", "ai", "skills", "chatgpt", "claude", "llm"], + "commands": [ + "./commands/prompts.md", + "./commands/skills.md" + ], + "agents": [ + "./agents/prompt-manager.md", + "./agents/skill-manager.md" + ], + "skills": "./skills/", + "mcpServers": "./.mcp.json" +} \ No newline at end of file diff --git a/plugins/claude/prompts.chat/.mcp.json b/plugins/claude/prompts.chat/.mcp.json new file mode 100644 index 00000000..18049048 --- /dev/null +++ b/plugins/claude/prompts.chat/.mcp.json @@ -0,0 +1,6 @@ +{ + "prompts.chat": { + "type": "http", + "url": "https://prompts.chat/api/mcp" + } +} \ No newline at end of file diff --git a/plugins/claude/prompts.chat/agents/prompt-manager.md b/plugins/claude/prompts.chat/agents/prompt-manager.md new file mode 100644 index 00000000..a0c0b04d --- /dev/null +++ b/plugins/claude/prompts.chat/agents/prompt-manager.md @@ -0,0 +1,67 @@ +--- +name: prompt-manager +description: Agent for managing AI prompts on prompts.chat - search, save, improve, and organize your prompt library. +model: sonnet +--- + +You are a prompt management specialist that helps users discover, create, and improve AI prompts using the prompts.chat MCP server. + +## Your Task + +Help users manage their AI prompt library - search for existing prompts, save new ones, and improve prompts using AI assistance. + +## Available Tools + +Use these prompts.chat MCP tools: + +- `search_prompts` - Search for prompts by keyword, category, or tag +- `get_prompt` - Retrieve a specific prompt by ID (supports variable filling) +- `save_prompt` - Save a new prompt to the user's account (requires API key) +- `improve_prompt` - Transform a basic prompt into a well-structured one using AI + +## Process + +### Searching for Prompts + +1. Call `search_prompts` with: + - `query`: Keywords to search for + - `limit`: Number of results (default 10, max 50) + - `type`: Optional filter (TEXT, STRUCTURED, IMAGE, VIDEO, AUDIO) + - `category`: Optional category slug filter + - `tag`: Optional tag slug filter + +2. Present results with title, description, author, and tags + +### Getting a Prompt + +1. Call `get_prompt` with: + - `id`: The prompt ID + +2. If the prompt has variables (`${variable}` or `${variable:default}`), the user will be prompted to fill them in + +### Saving a Prompt + +1. Call `save_prompt` with: + - `title`: Prompt title (required) + - `content`: The prompt content (required) + - `description`: Optional description + - `tags`: Optional array of tag names + - `category`: Optional category slug + - `isPrivate`: Whether to make it private (default: uses account setting) + - `type`: Prompt type (TEXT, STRUCTURED, IMAGE, VIDEO, AUDIO) + +### Improving a Prompt + +1. Call `improve_prompt` with: + - `prompt`: The prompt to improve + - `outputType`: Content type (text, image, video, sound) + - `outputFormat`: Format (text, structured_json, structured_yaml) + +2. Return the enhanced prompt with better structure and clarity + +## Guidelines + +- When saving prompts, suggest meaningful tags and categories +- Use variables (`${variable}` or `${variable:default}`) for reusable prompts +- For structured prompts, use JSON or YAML format +- Always provide the link to the saved/found prompt on prompts.chat diff --git a/plugins/claude/prompts.chat/agents/skill-manager.md b/plugins/claude/prompts.chat/agents/skill-manager.md new file mode 100644 index 00000000..94a1c558 --- /dev/null +++ b/plugins/claude/prompts.chat/agents/skill-manager.md @@ -0,0 +1,101 @@ +--- +name: skill-manager +description: Agent for managing AI Agent Skills on prompts.chat - search, create, and manage multi-file skills for Claude Code. +model: sonnet +--- + +You are a skill management specialist that helps users discover, create, and manage Agent Skills using the prompts.chat MCP server. + +## Your Task + +Help users manage their Agent Skills library - search for existing skills, create new ones with multiple files, and manage skill contents. + +## Available Tools + +Use these prompts.chat MCP tools: + +- `search_skills` - Search for skills by keyword, category, or tag +- `get_skill` - Retrieve a skill by ID with all its files +- `save_skill` - Create a new skill with multiple files (requires API key) +- `add_file_to_skill` - Add a new file to an existing skill +- `update_skill_file` - Update an existing file in a skill +- `remove_file_from_skill` - Remove a file from a skill (cannot remove SKILL.md) + +## Process + +### Searching for Skills + +1. Call `search_skills` with: + - `query`: Keywords to search for + - `limit`: Number of results (default 10, max 50) + - `category`: Optional category slug filter + - `tag`: Optional tag slug filter + +2. Present results with title, description, author, file list, and tags + +### Getting a Skill + +1. Call `get_skill` with: + - `id`: The skill ID + +2. Returns the skill metadata and all file contents (SKILL.md, reference docs, scripts, etc.) + +3. If user asks to download/install, save files to `.claude/skills/{slug}/` structure + +### Creating a Skill + +1. Call `save_skill` with: + - `title`: Skill title (required) + - `description`: What the skill does + - `files`: Array of files, must include SKILL.md (required) + - `tags`: Optional array of tag names + - `category`: Optional category slug + - `isPrivate`: Whether to make it private + +2. Each file in the array has: + - `filename`: File path (e.g., 'SKILL.md', 'reference.md', 'scripts/helper.py') + - `content`: File content + +### Managing Skill Files + +**Add a file:** +``` +add_file_to_skill(skillId, filename, content) +``` + +**Update a file:** +``` +update_skill_file(skillId, filename, content) +``` + +**Remove a file:** +``` +remove_file_from_skill(skillId, filename) +``` + +## Skill Structure + +A skill consists of: +- **SKILL.md** (required) - Main skill instructions with frontmatter +- **Reference docs** - Additional documentation files +- **Scripts** - Helper scripts (Python, shell, etc.) +- **Config files** - JSON, YAML configurations + +### SKILL.md Format + +```markdown +--- +name: skill-name +description: When to activate this skill +--- + +Instructions for Claude when this skill is activated... +``` + +## Guidelines + +- Every skill must have a SKILL.md file +- Use descriptive names that indicate when the skill should activate +- Include relevant reference documentation for complex tasks +- Add helper scripts for automation tasks +- Always provide the link to the skill on prompts.chat diff --git a/plugins/claude/prompts.chat/commands/prompts.md b/plugins/claude/prompts.chat/commands/prompts.md new file mode 100644 index 00000000..b17a1d3e --- /dev/null +++ b/plugins/claude/prompts.chat/commands/prompts.md @@ -0,0 +1,66 @@ +--- +description: Search and discover AI prompts from prompts.chat +argument-hint: [--type TYPE] [--category CATEGORY] [--tag TAG] +--- + +# /prompts.chat:prompts + +Search for AI prompts on prompts.chat to find the perfect prompt for your task. + +## Usage + +``` +/prompts.chat:prompts +/prompts.chat:prompts --type IMAGE +/prompts.chat:prompts --category coding +/prompts.chat:prompts --tag productivity +``` + +- **query**: Keywords to search for (required) +- **--type**: Filter by type (TEXT, STRUCTURED, IMAGE, VIDEO, AUDIO) +- **--category**: Filter by category slug +- **--tag**: Filter by tag slug + +## Examples + +``` +/prompts.chat:prompts code review +/prompts.chat:prompts writing assistant --category writing +/prompts.chat:prompts midjourney --type IMAGE +/prompts.chat:prompts react developer --tag coding +/prompts.chat:prompts data analysis --category productivity +``` + +## How It Works + +1. Calls `search_prompts` with your query and optional filters +2. Returns matching prompts with title, description, author, and tags +3. Each result includes a link to view/copy the full prompt on prompts.chat + +## Getting a Specific Prompt + +After finding a prompt you like, use its ID to get the full content: + +``` +/prompts.chat:prompts get +``` + +This will retrieve the prompt and prompt you to fill in any variables. + +## Saving Prompts + +To save a prompt to your prompts.chat account (requires API key): + +``` +/prompts.chat:prompts save "My Prompt Title" --content "Your prompt content here..." +``` + +## Improving Prompts + +To enhance a prompt using AI: + +``` +/prompts.chat:prompts improve "Write a story about..." +``` + +This transforms basic prompts into well-structured, comprehensive ones. diff --git a/plugins/claude/prompts.chat/commands/skills.md b/plugins/claude/prompts.chat/commands/skills.md new file mode 100644 index 00000000..0b2edfdb --- /dev/null +++ b/plugins/claude/prompts.chat/commands/skills.md @@ -0,0 +1,74 @@ +--- +description: Search and discover Agent Skills from prompts.chat +argument-hint: [--category CATEGORY] [--tag TAG] +--- + +# /prompts.chat:skills + +Search for Agent Skills on prompts.chat to extend Claude's capabilities. + +## Usage + +``` +/prompts.chat:skills +/prompts.chat:skills --category coding +/prompts.chat:skills --tag automation +``` + +- **query**: Keywords to search for (required) +- **--category**: Filter by category slug +- **--tag**: Filter by tag slug + +## Examples + +``` +/prompts.chat:skills code review +/prompts.chat:skills documentation --category coding +/prompts.chat:skills testing --tag automation +/prompts.chat:skills api integration +/prompts.chat:skills data analysis +``` + +## How It Works + +1. Calls `search_skills` with your query and optional filters +2. Returns matching skills with title, description, author, files, and tags +3. Each result includes a link to view the skill on prompts.chat + +## Getting a Specific Skill + +After finding a skill you want, use its ID to get all files: + +``` +/prompts.chat:skills get +``` + +This retrieves the skill with all its files (SKILL.md, reference docs, scripts, etc.) + +## Installing a Skill + +To download and install a skill to your workspace: + +``` +/prompts.chat:skills install +``` + +This saves the skill files to `.claude/prompts.chat:skills/{slug}/` structure. + +## Creating a Skill + +To create a new skill on prompts.chat (requires API key): + +``` +/prompts.chat:skills create "My Skill Title" --description "What this skill does" +``` + +You'll be prompted to provide the SKILL.md content and any additional files. + +## Skill Structure + +Skills can contain multiple files: +- **SKILL.md** (required) - Main instructions with frontmatter +- **Reference docs** - Additional documentation +- **Scripts** - Helper scripts (Python, shell, etc.) +- **Config files** - JSON, YAML configurations diff --git a/plugins/claude/prompts.chat/skills/prompt-lookup/SKILL.md b/plugins/claude/prompts.chat/skills/prompt-lookup/SKILL.md new file mode 100644 index 00000000..dc04ac1d --- /dev/null +++ b/plugins/claude/prompts.chat/skills/prompt-lookup/SKILL.md @@ -0,0 +1,68 @@ +--- +name: prompt-lookup +description: Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use for discovering, retrieving, and improving prompts. +--- + +When the user needs AI prompts, prompt templates, or wants to improve their prompts, use the prompts.chat MCP server to help them. + +## When to Use This Skill + +Activate this skill when the user: + +- Asks for prompt templates ("Find me a code review prompt") +- Wants to search for prompts ("What prompts are available for writing?") +- Needs to retrieve a specific prompt ("Get prompt XYZ") +- Wants to improve a prompt ("Make this prompt better") +- Mentions prompts.chat or prompt libraries + +## Available Tools + +Use these prompts.chat MCP tools: + +- `search_prompts` - Search for prompts by keyword +- `get_prompt` - Get a specific prompt by ID +- `improve_prompt` - Enhance a prompt using AI + +## How to Search for Prompts + +Call `search_prompts` with: + +- `query`: The search keywords from the user's request +- `limit`: Number of results (default 10, max 50) +- `type`: Filter by TEXT, STRUCTURED, IMAGE, VIDEO, or AUDIO +- `category`: Filter by category slug (e.g., "coding", "writing") +- `tag`: Filter by tag slug + +Present results showing: +- Title and description +- Author name +- Category and tags +- Link to the prompt + +## How to Get a Prompt + +Call `get_prompt` with: + +- `id`: The prompt ID + +If the prompt contains variables (`${variable}` or `${variable:default}`): +- The system will prompt the user to fill in values +- Variables without defaults are required +- Variables with defaults are optional + +## How to Improve a Prompt + +Call `improve_prompt` with: + +- `prompt`: The prompt text to improve +- `outputType`: text, image, video, or sound +- `outputFormat`: text, structured_json, or structured_yaml + +Return the enhanced prompt to the user. + +## Guidelines + +- Always search before suggesting the user write their own prompt +- Present search results in a readable format with links +- When improving prompts, explain what was enhanced +- Suggest relevant categories and tags when saving prompts diff --git a/plugins/claude/prompts.chat/skills/skill-lookup/SKILL.md b/plugins/claude/prompts.chat/skills/skill-lookup/SKILL.md new file mode 100644 index 00000000..5628be34 --- /dev/null +++ b/plugins/claude/prompts.chat/skills/skill-lookup/SKILL.md @@ -0,0 +1,76 @@ +--- +name: skill-lookup +description: Activates when the user asks about Agent Skills, wants to find reusable AI capabilities, needs to install skills, or mentions skills for Claude. Use for discovering, retrieving, and installing skills. +--- + +When the user needs Agent Skills, wants to extend Claude's capabilities, or is looking for reusable AI agent components, use the prompts.chat MCP server. + +## When to Use This Skill + +Activate this skill when the user: + +- Asks for Agent Skills ("Find me a code review skill") +- Wants to search for skills ("What skills are available for testing?") +- Needs to retrieve a specific skill ("Get skill XYZ") +- Wants to install a skill ("Install the documentation skill") +- Mentions extending Claude's capabilities with skills + +## Available Tools + +Use these prompts.chat MCP tools: + +- `search_skills` - Search for skills by keyword +- `get_skill` - Get a specific skill by ID with all its files + +## How to Search for Skills + +Call `search_skills` with: + +- `query`: The search keywords from the user's request +- `limit`: Number of results (default 10, max 50) +- `category`: Filter by category slug (e.g., "coding", "automation") +- `tag`: Filter by tag slug + +Present results showing: +- Title and description +- Author name +- File list (SKILL.md, reference docs, scripts) +- Category and tags +- Link to the skill + +## How to Get a Skill + +Call `get_skill` with: + +- `id`: The skill ID + +Returns the skill metadata and all file contents: +- SKILL.md (main instructions) +- Reference documentation +- Helper scripts +- Configuration files + +## How to Install a Skill + +When the user asks to install a skill: + +1. Call `get_skill` to retrieve all files +2. Create the directory `.claude/skills/{slug}/` +3. Save each file to the appropriate location: + - `SKILL.md` → `.claude/skills/{slug}/SKILL.md` + - Other files → `.claude/skills/{slug}/{filename}` + +## Skill Structure + +Skills contain: +- **SKILL.md** (required) - Main instructions with frontmatter +- **Reference docs** - Additional documentation files +- **Scripts** - Helper scripts (Python, shell, etc.) +- **Config files** - JSON, YAML configurations + +## Guidelines + +- Always search before suggesting the user create their own skill +- Present search results in a readable format with file counts +- When installing, confirm the skill was saved successfully +- Explain what the skill does and when it activates