feat(claude-plugin): add prompts.chat marketplace and plugin structure

This commit is contained in:
Fatih Kadir Akın
2026-01-16 00:38:37 +03:00
parent 2be8e547f1
commit ee2d61f8b9
11 changed files with 690 additions and 0 deletions

View File

@@ -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"]
}
]
}

166
CLAUDE-PLUGIN.md Normal file
View File

@@ -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 <query>
/prompts.chat:prompts <query> --type IMAGE
/prompts.chat:prompts <query> --category coding
/prompts.chat:prompts <query> --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 <query>
/prompts.chat:skills <query> --category coding
/prompts.chat:skills <query> --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

View File

@@ -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

View File

@@ -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"
}

View File

@@ -0,0 +1,6 @@
{
"prompts.chat": {
"type": "http",
"url": "https://prompts.chat/api/mcp"
}
}

View File

@@ -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

View File

@@ -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

View File

@@ -0,0 +1,66 @@
---
description: Search and discover AI prompts from prompts.chat
argument-hint: <query> [--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 <query>
/prompts.chat:prompts <query> --type IMAGE
/prompts.chat:prompts <query> --category coding
/prompts.chat:prompts <query> --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 <prompt-id>
```
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.

View File

@@ -0,0 +1,74 @@
---
description: Search and discover Agent Skills from prompts.chat
argument-hint: <query> [--category CATEGORY] [--tag TAG]
---
# /prompts.chat:skills
Search for Agent Skills on prompts.chat to extend Claude's capabilities.
## Usage
```
/prompts.chat:skills <query>
/prompts.chat:skills <query> --category coding
/prompts.chat:skills <query> --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 <skill-id>
```
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 <skill-id>
```
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

View File

@@ -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

View File

@@ -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