skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
openmbti/core76 installs

openjung-api

Guide for integrating with the OpenJung (OEJTS) personality test API - a free, open-source alternative to MBTI. Use when building applications that need personality assessment, integrating MBTI-style tests, or working with the OpenJung API endpoints. Covers: (1) Fetching test questions, (2) Submitting answers and calculating results, (3) Understanding the scoring system, (4) Recording test sessions, (5) Retrieving aggregate statistics.

How do I install this agent skill?

npx skills add https://github.com/openmbti/core --skill openjung-api
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a technical guide for integrating with the OpenJung personality test API. It contains documentation, API specifications, and code examples for building applications that perform personality assessments. The analysis found no security issues; the skill performs its stated function using standard programming practices.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    2 files scanned · No issues

What does this agent skill do?

OpenJung API Integration

OpenJung is an open-source personality test based on OEJTS (Open Extended Jungian Type Scales) - a validated 32-question assessment that determines MBTI-compatible personality types.

Base URL: https://openjung.org

Quick Start

Minimal Integration (3 Steps)

// 1. Fetch questions
const { questions } = await fetch('https://openjung.org/api/questions').then(r => r.json());

// 2. Collect user answers (32 questions, values 1-5)
const answers = { "1": 3, "2": 5, /* ... all 32 */ "32": 4 };

// 3. Calculate result
const { result } = await fetch('https://openjung.org/api/calculate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ answers })
}).then(r => r.json());

console.log(result.type); // "ENFP"

API Endpoints

GET /api/questions

Fetch all 32 test questions.

GET /api/questions?locale=en

Response:

{
  "totalQuestions": 32,
  "questions": [
    {
      "id": 1,
      "dimension": "JP",
      "leftTrait": "Makes lists",
      "rightTrait": "Relies on memory"
    }
  ]
}

POST /api/calculate

Calculate personality type from answers.

POST /api/calculate
{
  "answers": { "1": 3, "2": 5, ... "32": 4 },
  "locale": "en",    // optional
  "save": true       // optional - saves to database
}

Response:

{
  "result": {
    "type": "ENFP",
    "scores": { "EI": 18, "SN": 28, "TF": 22, "JP": 32 },
    "percentages": { "E": 75, "I": 25, "S": 12, "N": 88, "T": 31, "F": 69, "J": 0, "P": 100 },
    "typeInfo": {
      "name": "Campaigner",
      "description": "...",
      "strengths": ["..."],
      "weaknesses": ["..."]
    },
    "shareUrl": "https://openjung.org/type/enfp?ei=18&sn=28&tf=22&jp=32"
  },
  "recordId": "uuid"
}

POST /api/record

Record a completed test result (fire-and-forget).

POST /api/record
{
  "answers": { ... },
  "result": { "type": "ENFP", "scores": {...}, "percentages": {...} }
}

GET /api/stats

Get aggregate test statistics.

{
  "totalTests": 15234,
  "typeDistribution": [{ "type": "INFP", "count": 2341 }],
  "localeDistribution": [{ "locale": "en", "count": 8234 }]
}

Scoring System

Scale: 1-5 Likert (1 = strongly left trait, 5 = strongly right trait)

Dimensions (8 questions each):

  • EI: Extroversion (E) ↔ Introversion (I)
  • SN: Sensing (S) ↔ Intuition (N)
  • TF: Thinking (T) ↔ Feeling (F)
  • JP: Judging (J) ↔ Perceiving (P)

Score Range: 8-40 per dimension (8 questions × 1-5 scale)

Threshold: 24 (midpoint)

  • Score ≤ 24 → left preference (E, S, F, J)
  • Score > 24 → right preference (I, N, T, P)

Note: TF dimension is inverted - low score = F (Feeling), high = T (Thinking)

Question Mapping

DimensionQuestion IDs
JP1, 5, 9, 13, 17, 21, 25, 29
TF2, 6, 10, 14, 18, 22, 26, 30
EI3, 7, 11, 15, 19, 23, 27, 31
SN4, 8, 12, 16, 20, 24, 28, 32

Localization

44 languages supported. Pass locale parameter to endpoints:

  • en (English), zh (Simplified Chinese), ja (Japanese), ko (Korean)
  • es (Spanish), fr (French), de (German), pt (Portuguese)
  • And 36 more...

Error Handling

Error CodeDescription
INVALID_BODYMalformed JSON
INVALID_PARAMSMissing/wrong answers format
INCOMPLETE_ANSWERSNot all 32 questions answered
CALCULATION_FAILEDServer error

Resources

For detailed API specifications and TypeScript types, see references/api_reference.md.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/openmbti/core/openjung-api">View openjung-api on skillZs</a>