CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

shared-schemas

Use this skill when contributing to InsForge's shared schema package. This is for maintainers editing published Zod contracts, exported types, and shared API payload definitions consumed by InsForge packages in this repo and other InsForge tooling.

Quality

84%

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

The canonical home for this skill is shared-schemas in InsForge/InsForge

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 tight, well-structured instruction skill with concrete validation commands and a clear change-synchronization workflow. It stays within token budget and organizes cleanly; the main gaps are a missing schema-authoring example and an explicit error-recovery loop.

DimensionReasoningScore

Conciseness

Lean, directive prose with concrete paths and commands and no padding about concepts Claude already knows; not 5 because the downstream-consumer caveat is restated across Scope, Working Rules, and Validation, which could be tightened.

4 / 5

Actionability

Provides copy-pasteable validation commands ('cd packages/shared-schemas && npm run build', 'npx tsc --noEmit') and specific paths to check; not 5 because there is no concrete example of how to actually author or restructure a schema file.

4 / 5

Workflow Clarity

Working Rule 3 sequences schema change → backend → dashboard → import sweep → downstream callout, and the Validation section gives explicit checkpoints; not 5 because there is no explicit validate→fix→retry feedback loop.

4 / 5

Progressive Disclosure

Under 50 lines with no external references needed and clean section structure (Scope, Working Rules, Validation); per the simple-skill guideline this earns a 5 for well-organized sections.

5 / 5

Total

17

/

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, niche-scoped description that explicitly covers what the skill does and when to use it with concrete, domain-specific triggers. It is mostly distinct and specific, with only minor room to add synonyms or broaden the action set.

DimensionReasoningScore

Specificity

Quotes 'editing published Zod contracts, exported types, and shared API payload definitions' name several concrete actions/targets; falls short of 5 because the actions are all variants of 'editing' rather than a comprehensive set of distinct operations.

4 / 5

Completeness

Explicitly answers both: 'what' ('editing published Zod contracts, exported types, and shared API payload definitions') and 'when' ('Use this skill when contributing to InsForge's shared schema package') with concrete trigger phrasing.

5 / 5

Trigger Term Quality

Phrases like 'contributing to InsForge's shared schema package', 'Zod contracts', 'exported types', and 'API payload definitions' give good keyword coverage a maintainer would say; not 5 because common synonyms (e.g. 'Zod schemas', 'shared types') are absent.

4 / 5

Distinctiveness Conflict Risk

Tied to a named package and Zod contracts gives a clear niche with minimal conflict risk; not 5 because general schema/type-editing activity has minor overlap with broader TypeScript or schema skills.

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

InsForge/InsForge

Path

.claude/skills/insforge-dev/shared-schemas/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.