json-schema

1 stars
14
A

Use when working with JSON Schema for validation, including draft-07, 2019-09, and 2020-12 specifications

Also in: database

Third-Party Agent Skill: Review the code before installing. Agent skills execute in your AI assistant's environment and can access your files. Learn more about security

Installation for Agentic Skill

View all platforms →
skilz install mcclowes/vague/json-schema
skilz install mcclowes/vague/json-schema --agent opencode
skilz install mcclowes/vague/json-schema --agent codex
skilz install mcclowes/vague/json-schema --agent gemini

First time? Install Skilz: pip install skilz

Works with 22+ AI coding assistants

Cursor, Aider, Copilot, Windsurf, Qwen, Kimi, and more...

View All Agents
Download Agent Skill ZIP

Extract and copy to ~/.claude/skills/ then restart Claude Desktop

1. Clone the repository:
git clone https://github.com/mcclowes/vague
2. Copy the agent skill directory:
cp -r vague/.claude/skills/json-schema ~/.claude/skills/

Need detailed installation help? Check our platform-specific guides:

Related Agentic Skills

Agentic Skill Details

Repository
vague
Stars
1
Type
Technical
Meta-Domain
productivity
Primary Domain
json
Market Score
14

Agent Skill Grade

A
Score: 91/100 Click to see breakdown

Score Breakdown

Spec Compliance
12/15
PDA Architecture
28/30
Ease of Use
23/25
Writing Style
9/10
Utility
18/20
Modifiers: +1

Areas to Improve

  • Missing TOC in reference files
  • Use case labels add verbosity
  • Missing validation workflow

Recommendations

  • Add trigger phrases to description for discoverability
  • Add table of contents for files over 100 lines

Graded: 2026-01-24

Developer Feedback

I've been diving into your json-schema skill and really appreciate how you've structured the progressive disclosure—most schema validation tools bury their complexity upfront, but you've managed to keep the essentials accessible while still serving power users.

Links:

The TL;DR

You're at 91/100, solidly in A territory. This evaluation follows Anthropic's skill best practices and your strongest area is Progressive Disclosure Architecture (28/30)—you nailed the layering. The weakest relative area is Spec Compliance (12/15), which is fixable with a couple quick additions.

What's Working Well

  • Perfect layering structure: SKILL.md stays concise while delegating all details to exactly three reference files. Most people try to cram everything into one file—you didn't.
  • Token economy is tight: Quick Start gets straight to the point, heavy use of bullet lists, zero fluff. Every line earns its place.
  • Strong trigger terms: "JSON Schema", "validation", draft version numbers—the skill activates for the right use cases.
  • Realistic examples throughout: Your composition.md and ajv.md sections show actual input/output pairs that people can copy and modify, not abstract theory.

The Big One: Spec Compliance Description

Your description currently has only 1-2 trigger phrases, but it could be doing more heavy lifting for discoverability. Right now it reads pretty narrowly—you're leaving value on the table for users searching.

Current state: Generic description doesn't capture the breadth of what you cover (multiple JSON Schema drafts, Ajv integration, composition patterns).

The fix: Expand the description in your frontmatter to include more trigger phrases. Something like:

description: JSON Schema validation, draft version selection (Dr...

Report Security Issue

Found a security vulnerability in this agent skill?