json-schema-lookup
Guidelines for querying schemastore.org. Use when you need to validate or discover options for config files relating to popular open source projects.
How do I install this agent skill?
npx skills add https://github.com/sammcj/agentic-coding --skill json-schema-lookupIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides instructions for querying the official SchemaStore API to discover and inspect JSON schemas for common configuration files. It uses standard tools like curl and jq to interact with a well-known public service.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
JSON Schema Lookup via SchemaStore
Query schemastore.org's catalog of public configuration file schemas to validate structure, discover options, and check allowed values.
API
- Catalog:
https://www.schemastore.org/api/json/catalog.json- Structure:
{ "schemas": [{ "name", "description", "fileMatch", "url", "versions"? }] }
- Structure:
- Individual schemas: Fetch the
urlfrom the matching catalog entry
Workflow
1. Find the schema
Search the catalog by name or filename pattern:
# Search by name (case-insensitive)
curl -s https://www.schemastore.org/api/json/catalog.json | jq '.schemas[] | select(.name | test("tsconfig"; "i")) | {name, url, fileMatch}'
# Search by filename match
curl -s https://www.schemastore.org/api/json/catalog.json | jq '.schemas[] | select(.fileMatch[]? | test("package\\.json")) | {name, url}'
Alternatively, use WebFetch on the catalog URL and ask for the relevant entry.
2. Fetch and inspect the schema
# List top-level properties
curl -s SCHEMA_URL | jq '.properties | keys'
# Inspect a specific field (type, enum values, description)
curl -s SCHEMA_URL | jq '.properties.FIELD_NAME'
# Check definitions/shared types (schemas use $ref to these)
curl -s SCHEMA_URL | jq '.definitions.DEF_NAME.properties'
# Get the full schema (warning - might be large!)
curl -s SCHEMA_URL | jq .
3. Common queries
# Find enum values for a field
curl -s SCHEMA_URL | jq '.properties.FIELD.enum'
# List nested properties (e.g. compilerOptions in tsconfig)
curl -s SCHEMA_URL | jq '.definitions.compilerOptionsDefinition.properties.compilerOptions.properties | keys'
# Find all required fields
curl -s SCHEMA_URL | jq '.required'
Tips
- Some schemas use
allOf/anyOfcomposition -- check those arrays for the full property set - The
versionsfield on catalog entries provides version-specific schema URLs when available - Schema URLs vary: some point to
json.schemastore.org, others toraw.githubusercontent.com - For large schemas, query specific paths rather than dumping the entire document
- Cache the catalog response locally if making multiple lookups in one session
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/sammcj/agentic-coding/json-schema-lookup">View json-schema-lookup on skillZs</a>