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/systemonewithmodel,state, and aquestionsmap. - 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
mkdir -p ~/.claude/skills/jev-decisions
curl -fsSL https://jevhub.org/skills/jev-decisions/SKILL.md \
-o ~/.claude/skills/jev-decisions/SKILL.mdFor one project only, put it in .claude/skills/jev-decisions/ inside the repository instead.
mkdir -p ~/.codex/skills/jev-decisions
curl -fsSL https://jevhub.org/skills/jev-decisions/SKILL.md \
-o ~/.codex/skills/jev-decisions/SKILL.mdOther 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.
| Wrong | Right |
|---|---|
"model": "systemone" | "model": "jev-latest" or a pinned jev-1.13.0 |
"questions": [ ... ] (an array) | "questions": { "your_id": { ... } } (a map) |
instruction, options, labels | instructions and criteria |
A mode field | No such field. The question type is choice, score, or noul |
jev-1.13 or typesafe/jev-1.13 | jev-1.13.0 |
Reading confidence on a Noul | Nouls return only noul, the probability of yes |
| Rounding a Score to a level | Keep 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.
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai