CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

typesafe-ai

Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives. Its System One models, including Jev, turn natural language and application state into typed judgments and probabilities that code can combine. Use when a feature needs programmable common sense, when brainstorming what AI could make possible in an app, or when an LLM prompt-and-parse step could become a structured decision. Applications include routing, ranking, extraction, verification, and interactive experiences; these are starting points, not the limits. Read live docs and cookbooks to find useful patterns and discover new combinations.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/typesafe-ai/SKILL.md

The canonical home for this skill is typesafe-ai in compozy/compozy

SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, domain-specific guide with strong doc navigation and genuine design guidance, explicit validation/testing direction, and efficient prose. Its main weakness is actionability: it contains no executable code or worked request example, deferring all API/SDK mechanics to external live docs, which makes the first integration step entirely dependent on a successful docs fetch.

Suggestions

Add one minimal executable example in the body (e.g., a single HTTP or SDK call with one Choice question including state, instructions, and criteria) so an integration can start without first fetching live docs.

Include a compact example of a well-formed question object (state/instructions/criteria with named JSON fields) to make the 'Design the judgments' guidance concrete rather than descriptive.

Make the offline fallback specific: name which local files or installed SDK type definitions to consult when live docs are unreachable, instead of the vague 'use available local docs'.

DimensionReasoningScore

Conciseness

The body is dense with TypeSafe-specific guidance (primitive distinctions, Noul confidence semantics, state/instructions/criteria structure) and wastes little on concepts Claude already knows. A few passages carry philosophical framing ('Code owns the workflow; the model supplies programmable common sense') or expansive hedging that could be trimmed, so anchor 4 fits better than the perfectly lean anchor 5, and it is well above the noticeable padding of anchor 3.

4 / 5

Actionability

Concrete guidance exists — the .md-suffix trick for fetching Mintlify pages, the task-to-docs table, backticked state paths like `ticket.messages[0].text`, and per-pattern cookbook links — but there are no executable artifacts: no API call, SDK snippet, or example question/state JSON. Anchor 3 (some concrete guidance but incomplete, missing key details) fits; anchor 4 would require concrete code or commands, and everything executable is deferred to external live docs.

3 / 5

Workflow Clarity

The section order forms a coherent arc (read live docs → find the useful shape → design the judgments → compose and verify) and validation is explicit: 'Test representative cases and the resulting application behavior' plus failure triage ('inspect the exact state, questions, candidates, answers... Separate missing evidence, model errors, code errors, and service failures'). Anchor 4 fits — clear sequence with most checkpoints — falling short of anchor 5 because the sequence is implicit in section order rather than explicit numbered steps with checkpoints.

4 / 5

Progressive Disclosure

Sections are well organized and references are clearly signaled one level deep (docs index, a task-to-doc table, inline cookbook links); no local bundle files exist to structure. It falls short of anchor 5 because the offline fallback ('use available local docs or installed SDK types') points at unspecified resources, and a notable amount of design detail (primitive distinctions, question-design rules) is inlined in the overview rather than split into reference material.

4 / 5

Total

15

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it explicitly states what the skill does and gives three concrete 'Use when...' trigger conditions plus an application list. The main gaps are category-level framing of the core action and missing common synonyms (classification, structured output) that users might naturally say.

DimensionReasoningScore

Specificity

Names several concrete capabilities ('typed judgments and probabilities that code can combine', 'routing, ranking, extraction, verification, and interactive experiences'), but the core framing ('units of AI intelligence you can use like programming primitives') remains category-level rather than fully concrete operations. Fits anchor 4 — several specific actions with minor gaps — not 5, and clearly above the 1-2-action coverage of anchor 3.

4 / 5

Completeness

Explicitly answers both: what ('turn natural language and application state into typed judgments and probabilities that code can combine') and when ('Use when a feature needs programmable common sense, when brainstorming what AI could make possible in an app, or when an LLM prompt-and-parse step could become a structured decision'). The 'when' clause is explicit with three concrete trigger conditions, matching anchor 5 rather than anchor 4 where the 'when' would need to be more specific.

5 / 5

Trigger Term Quality

Includes natural trigger phrases users would say ('when brainstorming what AI could make possible in an app', 'when an LLM prompt-and-parse step could become a structured decision') plus application keywords (routing, ranking, extraction, verification). Missing common synonyms such as classification, structured output, or scoring, so it fits anchor 4 (good coverage, a few natural terms missing) rather than 5's comprehensive synonym coverage, and is well above anchor 3.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct (programmable common sense, typed judgments, named models TypeSafe/Jev), but 'brainstorming what AI could make possible in an app' and the LLM prompt-and-parse trigger create minor overlap risk with generic ideation, prompt-engineering, or structured-output skills. Fits anchor 4 (mostly distinct, minor overlap with closely related skills), not 5's minimal-conflict clear niche.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

phatblat/dotfiles

Path

.agents/skills/typesafe-ai/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.