directives

Pre-built custom directives for json-render — formatting, math, string manipulation, and i18n. Use when working with @json-render/directives, defining custom directives with defineDirective, or adding $format, $math, $concat, $count, $truncate, $pluralize, $join, or $t to specs.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

96%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 dense, executable, well-structured API reference that assumes Claude's intelligence and avoids fluff. The only improvement area is that the per-directive detail could live in a separate reference file to slim the main SKILL.md.

Suggestions

Move the per-directive 'Fields' detail and individual examples into a references/ file (e.g. DIRECTIVES.md) and keep SKILL.md as a concise overview with one-line summaries plus links.

Add a one-line validation hint for the 'Defining Custom Directives' Rules (e.g. confirm the $-prefix and no-conflict checks at definition time) to make the workflow more robust.

Dimension	Reasoning	Score
Conciseness	Lean and efficient: it assumes Claude's competence, never explains what directives or json-render are, and every line (Quick Start, Rules, per-directive examples, Fields) earns its place.	5 / 5
Actionability	Copy-paste-ready TypeScript/JSON examples cover wiring, defining custom directives, every built-in directive, composition, and renderer integration — fully executable with field tables for the common cases.	5 / 5
Workflow Clarity	This is a single-purpose library/reference skill with no destructive or batch operations, so the validation-cap does not apply; the Quick Start and Defining Custom Directives sections make the action (wire, use, define) unambiguous.	5 / 5
Progressive Disclosure	Well-organized into clear sections (Quick Start, Defining, Built-in Directives, Composition, Wiring, Key Exports), but it is a ~200-line single file with the full per-directive API inlined rather than split into a separate reference file.	4 / 5
	Total	19 / 20 Passed

Description

92%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, specific description that clearly answers both what the skill does and when to use it, scoped tightly to the @json-render/directives package. The only minor gap is the absence of synonyms or file extensions in the trigger terms.

Dimension	Reasoning	Score
Specificity	Names the domain and lists multiple concrete actions covering the full directive set ('formatting, math, string manipulation, and i18n') plus each directive token, matching the comprehensive-coverage anchor.	5 / 5
Completeness	Explicitly states both what it does ('Pre-built custom directives for json-render — formatting, math, string manipulation, and i18n') and when to use it ('Use when working with...'), with concrete trigger phrases.	5 / 5
Trigger Term Quality	'Use when working with @json-render/directives, defining custom directives with defineDirective, or adding $format, $math, $concat...' gives strong, natural trigger coverage matching what a developer would say, though it lacks synonyms or file extensions for a full 5.	4 / 5
Distinctiveness Conflict Risk	Tightly scoped to the @json-render/directives package and specific $-prefixed directive names, giving it a clear niche with minimal overlap risk.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

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: vercel-labs/json-render
Path: skills/directives/SKILL.md
Commit: 0f6798b

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.