PromptRank

PromptRank is a terminal-style prompt quiz that helps users test their prompting skill, discover their AI profile, and generate a shareable result card.

What It Does

• Presents 5 prompt scenarios
• Lets the user choose the best prompt or write their own
• Scores responses across clarity, creativity, technical depth, and strategy
• Generates a profile and Prompt IQ result
• Supports Turkish, English, and Spanish

Why This Repo Is Useful

This repo is not only the quiz app itself. It also includes reusable prompt-writing guidance for people who want to improve how they write prompts in real projects.

• Broader prompt evaluation logic in js/scorer.js
• A reusable prompt writing reference in PROMPT_GUIDE.md
• A static app that can be forked, customized, or embedded into learning content

How Users Use It

1. Open the app in a browser
2. Choose a language from the top-right selector
3. Press Start
4. Complete all 5 scenarios
5. Pick one of the prompt options or use the custom prompt field
6. Review the final Prompt IQ and profile card
7. Download the result card or share it

Run Locally

Because this is a static web app, no build step is required.

Option 1:

• Open index.html directly in a browser

Option 2:

• Serve the folder with any simple static server
• Example:

python -m http.server 8000

Then open http://localhost:8000.

Project Structure

• index.html: app layout
• css/style.css: terminal UI styles
• js/app.js: main app flow
• js/i18n.js: language strings
• js/scenarios.js: scenario content
• js/profiles.js: result profiles
• js/scorer.js: custom prompt scoring
• js/card.js: result card rendering/export

Notes

• Language selection is saved in local storage
• The app is fully client-side
• html2canvas is used for PNG export

Prompt Evaluation Criteria

PromptRank now evaluates more than just basic structure. The scoring logic looks for signals such as:

• role definition
• context quality
• target audience clarity
• output format specificity
• constraints and limits
• success criteria and metrics
• reasoning and trade-off requests
• verification and validation language
• technical depth
• edge cases and fallback thinking

For the full reusable guide, see PROMPT_GUIDE.md.

Live Version

PromptRank is available on GitHub Pages:

• https://hailneed.github.io/promptrank/