Documentation

Achievements

Promptmark includes a gamified onboarding system with 6 achievements that guide new users through the platform’s core features.

The 6 Achievements

Achievement Unlock Criteria Description
First Prompt Create your first prompt Get started by saving your first prompt
First Test Run your first test Send a prompt to an AI model
First Collection Create a collection Organize prompts into a collection
First Publish Make a prompt public Share a prompt with the world
First Remix Remix another user’s prompt Fork a public prompt into your library
First Template Use template variables Create or use a prompt with {{variable}} syntax

Dashboard Widget

New users see a “First Steps” widget on the dashboard showing their achievement progress. Each achievement displays as locked (gray) or unlocked (green) with a check mark.

Dismissing the Widget

After exploring the achievements, you can dismiss the dashboard widget:

  • Click the dismiss button on the widget
  • Or via API: DELETE /api/onboarding/dismiss
  • Or via MCP: dismiss_onboarding tool

Dismissing hides the widget from the dashboard only.

Restoring the Widget

To bring the widget back:

  • Via API: POST /api/onboarding/restore
  • Via MCP: restore_onboarding tool

Trophy Case

The trophy case is always visible in Settings, regardless of whether the dashboard widget is dismissed. It shows all 6 achievements with their unlock status and dates.

MCP Tools

Tool Description
list_achievements Get all 6 achievements with unlock status
dismiss_onboarding Hide the dashboard widget
restore_onboarding Show the dashboard widget again

Example Response

{
  "achievements": [
    {
      "id": "first_prompt",
      "name": "First Prompt",
      "unlocked": true,
      "unlocked_at": "2026-01-15T10:30:00Z"
    },
    {
      "id": "first_test",
      "name": "First Test",
      "unlocked": false,
      "unlocked_at": null
    }
  ],
  "dismissed": false
}