Help & Documentation
Learn how to use PromptScout's powerful prompt engineering features to create, manage, and optimize your prompts.
The Structured Prompt Builder helps you create well-organized prompts using a guided form interface. Instead of writing prompts from scratch, you fill in specific fields that are combined into an effective prompt.
Key Fields
Role / Persona
Define who the AI should act as (e.g., "expert data scientist", "creative writing assistant").
Task / Objective
Clearly state what you want the AI to accomplish.
Context
Provide background information the AI needs to understand the task.
Constraints
Set limitations such as word count, tone, or formatting requirements.
Output Format
Specify how the response should be structured (e.g., bullet points, JSON, markdown).
Examples
Add example inputs and outputs to guide the AI's responses.
Templates are pre-built prompt structures designed for specific use cases. They help you get started quickly and ensure best practices are followed.
Using Templates
- Click "Browse Templates" in the prompt editor
- Browse by category or search for specific templates
- Preview the template structure before applying
- Click "Use Template" to apply it to your prompt
- Customize the template fields for your specific needs
Creating Custom Templates
- Create a prompt using the structured builder
- Click "Save as Template" from the prompt actions menu
- Add a name, description, and category
- Mark which fields should be editable vs. fixed
- Share with your team or keep private
Every time you save a prompt, a new version is automatically created. This allows you to track changes over time and restore previous versions if needed.
How Versioning Works
- Versions are created automatically on save
- Each version has a timestamp and optional commit message
- View the full history in the version sidebar
- Compare any two versions side-by-side
- Restore previous versions with one click
Restoring a Version
- Open the version history sidebar
- Select the version you want to restore
- Preview the version content
- Click "Restore Version"
- The restored content becomes a new version (preserving history)
Collections help you organize your prompts into logical groups. You can create collections for different projects, clients, or use cases.
Managing Collections
- Create new collections from the dashboard sidebar
- Drag and drop prompts into collections
- A prompt can belong to multiple collections
- Add descriptions and colors to collections
- Share collections with team members
Collection Features
- Nested Collections: Create sub-collections for better organization
- Quick Access: Pin frequently used collections to the top
- Bulk Actions: Move or copy multiple prompts at once
- Smart Collections: Auto-organize prompts by tags or categories
Use AI-powered chat to iteratively improve your prompts. Describe what you want to change, and the AI will suggest improvements while explaining the reasoning.
How to Use
- Open the refinement panel from the prompt editor
- Type your request (e.g., "Make this more concise")
- Review the AI's suggested changes
- Accept, modify, or reject each suggestion
- Continue the conversation to refine further
Example Refinement Requests
- "Make the tone more professional"
- "Add more specific examples"
- "Reduce ambiguity in the instructions"
- "Optimize for GPT-4 vs Claude"
- "Add error handling instructions"
Test your prompts against multiple AI models to compare outputs, measure quality, and ensure consistency across different scenarios.
Running Tests
- Open the test panel or press Cmd+Enter
- Select one or more AI models to test against
- Optionally add test variables/inputs
- Run the test and wait for results
- Compare outputs side-by-side
Test Features
- Multi-Model Testing: Compare GPT-4, Claude, and other models simultaneously
- Variable Injection: Test with different input values
- Output Metrics: Track response length, latency, and token usage
- Test History: View and compare previous test runs
- Batch Testing: Run multiple test cases at once
Speed up your workflow with keyboard shortcuts. All shortcuts work across the application.