Skills

Jev skill for coding agents

A SKILL.md your coding agent loads when it writes code that calls Jev. It keeps the request shape, the three question types, and confidence handling correct, and it tells the agent when Jev is the wrong tool.

What the skill covers

  • The request: POST https://api.typesafe.ai/v1/systemone with model, state, and a questions map.
  • Choice, Score, and Noul: what each returns and how to phrase the question.
  • Batching several questions about one state into one request.
  • Confidence gates, threshold constants in one file, and model pinning.
  • When to call the Jev MCP server tools instead of writing code.
  • When not to use Jev: prose, code generation, and open-ended answers.

Read the full SKILL.md. It is plain Markdown, about 170 lines.

Install

Claude Code (all projects)
mkdir -p ~/.claude/skills/jev-decisions
curl -fsSL https://jevhub.org/skills/jev-decisions/SKILL.md \
  -o ~/.claude/skills/jev-decisions/SKILL.md

For one project only, put it in .claude/skills/jev-decisions/ inside the repository instead.

Codex
mkdir -p ~/.codex/skills/jev-decisions
curl -fsSL https://jevhub.org/skills/jev-decisions/SKILL.md \
  -o ~/.codex/skills/jev-decisions/SKILL.md

Other agents: add the file to the agent's skills or rules folder, or paste its contents into the project instructions.

Mistakes it prevents

These show up in public Jev code and copied snippets. Each one makes the API reject the request or quietly answer a different question.

WrongRight
"model": "systemone""model": "jev-latest" or a pinned jev-1.13.0
"questions": [ ... ] (an array)"questions": { "your_id": { ... } } (a map)
instruction, options, labelsinstructions and criteria
A mode fieldNo such field. The question type is choice, score, or noul
jev-1.13 or typesafe/jev-1.13jev-1.13.0
Reading confidence on a NoulNouls return only noul, the probability of yes
Rounding a Score to a levelKeep the float; 1.4 between levels is information

The official TypeSafe skill

TypeSafe publishes its own skill with the full API reference and cookbooks. It is longer; this one is short and adds the MCP tools and the mistakes above. Installing both is fine.

Official skill in Claude Code
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai