Agent skill

Add JSON Schema

Add a new downloadable JSON schema to the Resources page — Kotlin provider class only, auto-discovered by Spring.

MITAuto-check passedMobile

Install Add JSON Schema

skills CLI

$ npx skills add yontrack/yontrack --skill add-json-schema -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install yontrack/yontrack add-json-schema --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/yontrack/yontrack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/add-json-schema .claude/skills/add-json-schema && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "add-json-schema" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-json-schema into .claude/skills/add-json-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-json-schema", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-json-schema

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add yontrack/yontrack --skill add-json-schema -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install yontrack/yontrack add-json-schema --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yontrack/yontrack.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/add-json-schema .agents/skills/add-json-schema && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "add-json-schema" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-json-schema into .agents/skills/add-json-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-json-schema", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add yontrack/yontrack --skill add-json-schema -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install yontrack/yontrack add-json-schema --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yontrack/yontrack.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/add-json-schema .cursor/skills/add-json-schema && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "add-json-schema" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-json-schema into .cursor/skills/add-json-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-json-schema", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/yontrack/yontrack.git --path .claude/skills/add-json-schema

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add yontrack/yontrack --skill add-json-schema -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install yontrack/yontrack add-json-schema --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yontrack/yontrack.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/add-json-schema .gemini/skills/add-json-schema && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "add-json-schema" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-json-schema into .gemini/skills/add-json-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-json-schema", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install yontrack/yontrack add-json-schema

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add yontrack/yontrack --skill add-json-schema -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/yontrack/yontrack.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/add-json-schema .github/skills/add-json-schema && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "add-json-schema" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-json-schema into .github/skills/add-json-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-json-schema", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add yontrack/yontrack --skill add-json-schema -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install yontrack/yontrack add-json-schema --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yontrack/yontrack.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/add-json-schema .opencode/skills/add-json-schema && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "add-json-schema" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-json-schema into .opencode/skills/add-json-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-json-schema", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: add-json-schema
GitHub stars: 102
Token cost: ~883 tokens
SKILL.md length: 216 words
Files: 1
Skills in repo: 7
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Add a new downloadable JSON schema to the Resources page — Kotlin provider class only, auto-discovered by Spring.

Works in 3 steps: Create the provider class → Verify root class annotations → No further wiring needed
Asked to expose a JSON schema for a configuration
SKILL.md covers Step 1 — Create the provider…, Step 2 — Verify root class…, Step 3 — No further wiring… and Final checklist
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Add JSON Schema is an agent skill from yontrack/yontrack. Add a new downloadable JSON schema to the Resources page — Kotlin provider class only, auto-discovered by Spring. Use when asked to expose a JSON schema for a configuration or data class.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Android development. It works with Kotlin. The repository describes itself as: Continuous delivery monitoring. The licence is MIT.

When your agent uses it

Asked to expose a JSON schema for a configuration
Tasks that involve Android development

Example prompts

“/add-json-schema”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Create the provider class
Verify root class annotations
No further wiring needed

What it can do on your machine

Read from SKILL.md and the folder at commit 8b8cd43. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are kotlin).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Add JSON Schema loads about 883 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 216 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~51
When it runs · the whole SKILL.md, loaded when a task matches: ~883

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yontrack/yontrack at commit 8b8cd43, republished under its MIT licence (© yontrack). 216 words, ~883 tokens.

Download SKILL.mdSave it as .claude/skills/add-json-schema/SKILL.md (or your agent's skills folder).

name: add-json-schema
description: Add a new downloadable JSON schema to the Resources page — Kotlin provider class only, auto-discovered by Spring. Use when asked to expose a JSON schema for a configuration or data class.
user-invocable: true

/add-json-schema — Add a Yontrack JSON Schema Provider

Arguments passed: $ARGUMENTS

Parse $ARGUMENTS for:

Schema key — kebab-case identifier (e.g. auto-versioning), used in the download URL
Root Kotlin class — the data class to generate the schema from (e.g. AutoVersioningConfig)
Module / package — the extension module where the provider class should live (e.g. ontrack-extension-auto-versioning, package net.nemerosa.ontrack.extension.av.config)

If any of these are missing, ask the user before proceeding.

Step 1 — Create the provider class

In the target module and package, create {Name}JsonSchemaProvider.kt:

kotlin

package {package}

import com.fasterxml.jackson.databind.JsonNode
import net.nemerosa.ontrack.json.asJson
import net.nemerosa.ontrack.model.json.schema.AbstractJsonSchemaProvider
import net.nemerosa.ontrack.model.json.schema.JsonSchemaBuilderService
import net.nemerosa.ontrack.model.support.EnvService
import org.springframework.stereotype.Component

@Component
class {Name}JsonSchemaProvider(
    envService: EnvService,
    private val jsonSchemaBuilderService: JsonSchemaBuilderService,
) : AbstractJsonSchemaProvider(envService) {

    override val key: String = "{schema-key}"
    override val title: String = "{Human-readable title}"
    override val description: String = "JSON schema for {description}"

    override fun createJsonSchema(): JsonNode =
        jsonSchemaBuilderService.createSchema(
            ref = "{schema-key}",
            id = id,
            title = title,
            description = description,
            root = {RootClass}::class,
        ).asJson()
}

Reference implementation: CIConfigJsonSchemaProvider.kt in ontrack-extension-config/src/main/java/net/nemerosa/ontrack/extension/config/schema/.

Step 2 — Verify root class annotations

Open the root data class and ensure fields have @APIDescription annotations so the generated schema includes meaningful descriptions:

kotlin

import net.nemerosa.ontrack.common.api.APIDescription

@APIDescription("Description of this configuration.")
data class {RootClass}(
    @APIDescription("What this field represents")
    val field1: String,
    // ...
)

Also annotate any nested data classes the same way.

Step 3 — No further wiring needed

Spring auto-discovers all @Component classes that extend AbstractJsonSchemaProvider. The following are handled automatically:

REST download endpoint: GET /rest/ref/schema/json/{schema-key} — served by the existing JsonSchemaController
GraphQL metadata: the schema appears in query { jsonSchemaDefinitions { key title description } } automatically
Resources page: the frontend JsonSchemasTable queries jsonSchemaDefinitions and renders a download link for every registered provider — no frontend change required

Final checklist

{Name}JsonSchemaProvider.kt created with @Component, correct key, title, description
createJsonSchema() delegates to jsonSchemaBuilderService.createSchema(root = {RootClass}::class)
Root data class (and nested classes) have @APIDescription on the class and its fields
Schema appears on the Resources page at /core/ref/resources

Files

Just SKILL.md in .claude/skills/add-json-schema of yontrack/yontrack.

Open the folder on GitHubat commit 8b8cd43

Compare with similar skills

Add JSON Schema next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Add JSON Schema compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Add JSON Schema this skillyontrack/yontrack	102	—	~883	Automated safety check: Pass	MIT	yesterday
Compose Multiplatform Patternsmonta-app/ocpp-emulator	180	5 repos	~2k	Automated safety check: Pass	Apache-2.0	7 days ago
Kotlin Patternsgetknit/knit	131	5 repos	~4.7k	Automated safety check: Pass	GPL-3.0	4 days ago
Summoncodeyousef/summon	167	—	~1.1k	Automated safety check: Pass	Apache-2.0	1 mo ago
Add Ktnip Parameter Strategyvendelieu/telegram-bot	249	—	~613	Automated safety check: Pass	Apache-2.0	4 days ago
CometChat Android v5 Headless SDKcometchat/cometchat-skills	130	—	~4k	Automated safety check: Pass	MIT	3 days ago

Similar skills

Compose Multiplatform Patterns
monta-app/ocpp-emulator
Compose Multiplatform and Jetpack Compose patterns for KMP projects — state management, navigation, theming, performance, and platform-specific UI.
180 GitHub starsUsed in 5 repos~2k tokens
MobileAuto-check passed
Kotlin Patterns
getknit/knit
Idiomatic Kotlin patterns, best practices, and conventions for building robust, efficient, and maintainable Kotlin applications with coroutines, null safety, and DSL builders.
131 GitHub starsUsed in 5 repos~4.7k tokens
MobileAuto-check passed
Summon
codeyousef/summon
A skill your agent uses when developing applications with the Summon Kotlin Multiplatform UI framework.
167 GitHub stars~1.1k tokensUpdated 1 mo ago
MobileAuto-check passed
Add Ktnip Parameter Strategy
vendelieu/telegram-bot
Adds a new parameter resolution strategy to the ktnip KSP processor.
249 GitHub stars~613 tokensUpdated 4 days ago
MobileAuto-check passed
CometChat Android v5 Headless SDK
cometchat/cometchat-skills
Builds chat on Android with your own UI against the headless CometChat Chat SDK v5, covering install, Jetifier conflicts, credentials and init-before-login ordering.
130 GitHub stars~4k tokensUpdated 3 days ago
MobileAuto-check passed
Kotlin Control Flow
chrisbanes/skills
A skill your agent uses when writing or reviewing Kotlin branching and control flow: when expressions, guard conditions, sealed type exhaustiveness, smart casts, nullable branching, early returns…
1.1k GitHub stars~1.2k tokensUpdated 4 days ago
MobileAuto-check passed

Questions about Add JSON Schema

What does Add JSON Schema do?

Add a new downloadable JSON schema to the Resources page — Kotlin provider class only, auto-discovered by Spring. Add JSON Schema is an agent skill from yontrack/yontrack. Add a new downloadable JSON schema to the Resources page — Kotlin provider class only, auto-discovered by Spring.

When should I use Add JSON Schema?

Add JSON Schema fits situations like: asked to expose a JSON schema for a configuration; tasks that involve Android development.

How do I install Add JSON Schema in Claude Code?

Run `npx skills add yontrack/yontrack --skill add-json-schema -a claude-code`. Or copy the skill folder (.claude/skills/add-json-schema in yontrack/yontrack) into .claude/skills/add-json-schema in your project. Claude Code loads it when a task matches its description.

How do I install Add JSON Schema in Codex?

Run `npx skills add yontrack/yontrack --skill add-json-schema -a codex`. Or copy the skill folder (.claude/skills/add-json-schema in yontrack/yontrack) into .agents/skills/add-json-schema in your project. Codex loads it when a task matches its description.

Can I use Add JSON Schema in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yontrack/yontrack --skill add-json-schema -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-json-schema, .gemini/skills/add-json-schema, .github/skills/add-json-schema and .opencode/skills/add-json-schema in your project.

What does Add JSON Schema need to run?

SKILL.md names no scripts, command-line tools or credentials: Add JSON Schema is instructions for the agent only.

Does Add JSON Schema access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Add JSON Schema safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Add JSON Schema use?

Add JSON Schema is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add JSON Schema use?

About 883 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Add JSON Schema?

Skills that share tags, products or a category with Add JSON Schema: Compose Multiplatform Patterns (monta-app/ocpp-emulator, 180 stars), Kotlin Patterns (getknit/knit, 131 stars), Summon (codeyousef/summon, 167 stars) and Add Ktnip Parameter Strategy (vendelieu/telegram-bot, 249 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add JSON Schema?

yontrack (a GitHub organization) maintains it in yontrack/yontrack, which has 102 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

Source: yontrack/yontrack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Add JSON Schema

Install Add JSON Schema

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

/add-json-schema — Add a Yontrack JSON Schema Provider

Step 1 — Create the provider class

Step 2 — Verify root class annotations

Step 3 — No further wiring needed

Final checklist

Files

Compare with similar skills

Similar skills

Compose Multiplatform Patterns

Kotlin Patterns

Summon

Add Ktnip Parameter Strategy

CometChat Android v5 Headless SDK

Kotlin Control Flow

More from yontrack/yontrack

Add Property Type

Add Widget

Fix Issue

New Extension

Release Milestone

Run Initiative

Questions about Add JSON Schema

Install Add JSON Schema

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

/add-json-schema — Add a Yontrack JSON Schema Provider

Step 1 — Create the provider class

Step 2 — Verify root class annotations

Step 3 — No further wiring needed

Final checklist

Files

Compare with similar skills

Similar skills

More from yontrack/yontrack

Related

Questions about Add JSON Schema