Claude Code Json Schema banner
hesreallyhim hesreallyhim

Claude Code Json Schema

Development community

Description

Unofficial JSON Schema definitions for Claude Code, including plugins and marketplaces

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

~~claude-code-json-schema~~

WE DID IT!*

I'm archiving this project for now because official schemas have finally been published:

That's very nice of them to do this and I trust that they will make sure to keep them up to date.

*This is just tongue-in-cheek - I have to say that because people seem to get the wrong idea. I don't think this repo had any impact on what they do over there.


Unofficial but really actually quite good JSON Schemas for Claude Code manifest files like `plugin.json` and `marketplace.json`. Intended to support developer tooling, plugin authors, and IDE integrations.

This project is not an authoritative specification and is not endorsed by, or affiliated with, or funded by, or probably even noticed by Anthropic PBC. It's partly a result of a sleepless night failing miserably to publish a plugin. Nevertheless, I think Codex did a pretty good job with it, and a best effort is made to ensure it's up to date with current documentation and the Claude Code application itself.

In addition, if you can believe it, this repo _itself_ houses its own plugin marketplace, which is just so Nolan-esque.

Schemas

File Description
`schemas/plugin.schema.json` Plugin manifest schema (.claude-plugin/plugin.json)
`schemas/marketplace.schema.json` Marketplace manifest schema (.claude-plugin/marketplace.json)

Quick start

For linting:

# I recommend assigning an alias to this:
npx github:hesreallyhim/claude-code-json-schema /path/to/project

IDE integration

See [`USAGE.md`](./USAGE.md) for VS Code and JetBrains setup.

Fixtures

[!NOTE] [We have decided on a cleaner way to organize