Problem
The typesafe-ai skill description: is truncated to ~60 characters in skill-suggestion indexes. The current wording leads with generic "typed" language, so TypeScript / static-types / Zod / mypy / "is this pipeline type-safe?" requests rank typesafe-ai at stage 1 even though the skill is for TypeSafe/Jev System One judgments in code.
Evidence (jev-1.13.0, cookbook two-pass, 60 fixtures, 33-skill roster)
Before the description rewrite:
typesafe-ai never wrong-loaded on 20/20 wrong-load fixtures
- correct 85% (17/20); 3 design/brainstorm misses gated out near 0.29
- Stage-1 top-1 0.49 on a JSON-to-TS types request; only the second pass rejected it
After rewriting the description (and a 4th design-gate Noul in the local eval harness):
typesafe-ai still never wrong-loaded, 20/20
- correct 20/20
- none 18/20; remaining two needless loads are
grounded-citations on weather/eclipse, not typesafe-ai
Proposed change
Only skills/typesafe-ai/SKILL.md description: (frontmatter). Body unchanged.
Lead the truncated index with TypeSafe/Jev Choice/Noul/Score in code, and name TypeScript / Zod / Pydantic / mypy / JSON Schema exclusions so a 60-character clip is not a lexical magnet for ordinary typed-programming requests.
Commit: ae44b3d on https://github.com/Louranicas/skills/tree/desc-index-line-not-ts-types
description: >
- 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.
+ TypeSafe/Jev: Choice/Noul/Score in code, not TS types. System One
+ models turn natural language and application state into probabilities
+ that software can compose. Use when building routing, ranking,
+ extraction, verification, or replacing an LLM prompt-and-parse step
+ with structured decisions; also when brainstorming what TypeSafe could
+ make possible. Do not use for TypeScript/Java/Rust static types,
+ Zod/Pydantic/mypy/JSON Schema/protobuf codegen, or asking whether a
+ data pipeline is "type-safe". Read live docs and cookbooks for current
+ primitives, APIs, and patterns.
Pull requests appear disabled on this repository (CreatePullRequest HTTP 403), so this issue is the contribution path. Happy to adjust wording if maintainers prefer a different index lead.
Problem
The
typesafe-aiskilldescription:is truncated to ~60 characters in skill-suggestion indexes. The current wording leads with generic "typed" language, so TypeScript / static-types / Zod / mypy / "is this pipeline type-safe?" requests ranktypesafe-aiat stage 1 even though the skill is for TypeSafe/Jev System One judgments in code.Evidence (jev-1.13.0, cookbook two-pass, 60 fixtures, 33-skill roster)
Before the description rewrite:
typesafe-ainever wrong-loaded on 20/20 wrong-load fixturesAfter rewriting the description (and a 4th design-gate Noul in the local eval harness):
typesafe-aistill never wrong-loaded, 20/20grounded-citationson weather/eclipse, nottypesafe-aiProposed change
Only
skills/typesafe-ai/SKILL.mddescription:(frontmatter). Body unchanged.Lead the truncated index with TypeSafe/Jev Choice/Noul/Score in code, and name TypeScript / Zod / Pydantic / mypy / JSON Schema exclusions so a 60-character clip is not a lexical magnet for ordinary typed-programming requests.
Commit:
ae44b3don https://github.com/Louranicas/skills/tree/desc-index-line-not-ts-typesPull requests appear disabled on this repository (CreatePullRequest HTTP 403), so this issue is the contribution path. Happy to adjust wording if maintainers prefer a different index lead.