Agent skill

Add Widget

Scaffold a new Yontrack dashboard widget end-to-end — Kotlin AbstractWidget class with config data class, and two frontend components (display + form).

MITAuto-check passedMobile

Install Add Widget

skills CLI

$ npx skills add yontrack/yontrack --skill add-widget -a claude-code

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

GitHub CLI

$ gh skill install yontrack/yontrack add-widget --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-widget .claude/skills/add-widget && 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-widget" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-widget into .claude/skills/add-widget/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-widget", 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-widget

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-widget -a codex

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

GitHub CLI

$ gh skill install yontrack/yontrack add-widget --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-widget .agents/skills/add-widget && 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-widget" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-widget into .agents/skills/add-widget/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-widget", 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-widget -a cursor

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

GitHub CLI

$ gh skill install yontrack/yontrack add-widget --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-widget .cursor/skills/add-widget && 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-widget" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-widget into .cursor/skills/add-widget/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-widget", 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-widget

--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-widget -a gemini-cli

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

GitHub CLI

$ gh skill install yontrack/yontrack add-widget --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-widget .gemini/skills/add-widget && 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-widget" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-widget into .gemini/skills/add-widget/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-widget", 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-widget

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-widget -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-widget .github/skills/add-widget && 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-widget" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-widget into .github/skills/add-widget/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-widget", 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-widget -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-widget --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-widget .opencode/skills/add-widget && 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-widget" agent skill from https://github.com/yontrack/yontrack/tree/main/.claude/skills/add-widget into .opencode/skills/add-widget/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-widget", 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-widget
GitHub stars: 102
Token cost: ~1.6k tokens
SKILL.md length: 370 words
Files: 1
Skills in repo: 7
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Scaffold a new Yontrack dashboard widget end-to-end — Kotlin AbstractWidget class with config data class, and two frontend components (display + form).

Works in 4 steps: Kotlin widget class → Display component → Form component → …
Asked to create a new dashboard widget
SKILL.md covers Step 1 — Kotlin widget class, Step 2 — Display component, Step 3 — Form component and Step 4 — Final checklist
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Add Widget is an agent skill from yontrack/yontrack. Scaffold a new Yontrack dashboard widget end-to-end — Kotlin AbstractWidget class with config data class, and two frontend components (display + form). Use when asked to create a new dashboard widget.

Its SKILL.md is about 1.6k 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 create a new dashboard widget
Tasks that involve Android development

Example prompts

“/add-widget”

Workflow steps

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

Kotlin widget class
Display component
Form component
Final checklist

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 javascript and 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 Widget loads about 1.6k tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 370 words of instructions outside code blocks.

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

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). 370 words, ~1,559 tokens.

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

name: add-widget
description: Scaffold a new Yontrack dashboard widget end-to-end — Kotlin AbstractWidget class with config data class, and two frontend components (display + form). Use when asked to create a new dashboard widget.
user-invocable: true

Arguments passed: $ARGUMENTS

Parse $ARGUMENTS for the widget name in PascalCase (e.g. MyFeature). If not provided, ask the user for:

Widget name (PascalCase, e.g. MyFeature)
A short human-readable name and description
The config fields it needs (name, type, default value) — or none
The preferred height (default 20)

Derive:

{Name} — the PascalCase widget name (e.g. BranchStatuses)
{key} — home/{Name} (e.g. home/BranchStatuses)
{KtFile} — {Name}Widget.kt
{JsWidget} — {Name}Widget.js
{JsForm} — {Name}WidgetForm.js

Create ontrack-model/src/main/java/net/nemerosa/ontrack/model/dashboards/widgets/{Name}Widget.kt:

kotlin

package net.nemerosa.ontrack.model.dashboards.widgets

import org.springframework.stereotype.Component

@Component
class {Name}Widget : AbstractWidget<{Name}WidgetConfig>(
    key = "home/{Name}",
    name = "{Human name}",
    description = "{Description}",
    defaultConfig = {Name}WidgetConfig(),
    preferredHeight = 20,
)

data class {Name}WidgetConfig(
    // add config fields here, e.g.:
    // val count: Int = 10,
) : WidgetConfig

The key value must match "home/{Name}" exactly — it is used by the frontend to locate the JS components.
If the widget has no configuration fields, keep the data class empty.
Add val refreshInterval: Duration = Duration.ZERO (and import java.time.Duration) if the widget should support auto-refresh.
For complex configs, nest additional data classes inside {Name}WidgetConfig or extract them to the same file.

Examples:

Simple (one int field): ontrack-model/.../dashboards/widgets/LastActiveProjectsWidget.kt
No config: ontrack-model/.../dashboards/widgets/FavouriteProjectsWidget.kt
Complex config: ontrack-model/.../dashboards/widgets/BranchStatusesWidget.kt

Step 2 — Display component

Create ontrack-web-core/components/widgets/home/{Name}Widget.js:

javascript

import {useContext, useEffect} from "react";
import {DashboardWidgetCellContext} from "@components/dashboards/DashboardWidgetCellContextProvider";
// import other hooks / components as needed

export default function {Name}Widget({
    // destructure all config fields here, e.g.:
    // count = 10,
}) {
    const {setTitle} = useContext(DashboardWidgetCellContext)
    useEffect(() => {
        setTitle("{Human name}")
    }, [])

    // Fetch and render data here

    return (
        <>
            {/* widget content */}
        </>
    )
}

Key rules:

Props mirror the config fields of {Name}WidgetConfig (Kotlin field names, camelCase).
Call setTitle(...) via DashboardWidgetCellContext so the cell header shows a meaningful title.
For data fetching use useQuery from @components/services/GraphQL (declarative), or callGraphQL from the same module when imperative fetching is needed.
Wrap content in <PaddedContent> (@components/common/PaddedContent) when the widget displays a list or table that needs padding.

Examples:

ontrack-web-core/components/widgets/home/LastActiveProjectsWidget.js (simple, useQuery)
ontrack-web-core/components/widgets/home/BranchStatusesWidget.js (complex, multi-query)

Show full SKILL.md (143 more words)Show less

Step 3 — Form component

Create ontrack-web-core/components/widgets/home/{Name}WidgetForm.js:

When the widget has config fields:

javascript

import {Form, InputNumber} from "antd";
import {useContext} from "react";
import {DashboardWidgetCellContext} from "@components/dashboards/DashboardWidgetCellContextProvider";

export default function {Name}WidgetForm({
    // destructure all config fields here (same as widget component)
    // count = 10,
}) {
    const {widgetEditionForm} = useContext(DashboardWidgetCellContext)

    return (
        <>
            <Form
                layout="vertical"
                form={widgetEditionForm}
            >
                {/* one Form.Item per config field, e.g.: */}
                <Form.Item
                    name="count"
                    label="Number of items to display"
                    initialValue={count}
                >
                    <InputNumber min={1} max={100} step={1}/>
                </Form.Item>
            </Form>
        </>
    )
}

When the widget has no config fields:

javascript

import {Typography} from "antd";

export default function {Name}WidgetForm() {
    return (
        <>
            <Typography.Text type="secondary">
                No configuration is needed.
            </Typography.Text>
        </>
    )
}

Key rules:

Always use <Form layout="vertical" form={widgetEditionForm}> — never create a new form instance.
Each Form.Item name must exactly match the corresponding Kotlin config field name (camelCase).
Pass the current prop value as initialValue on each Form.Item so the form is pre-populated when opened.
For list-of-objects config fields, use <Form.List> (see BranchStatusesWidgetForm.js for an example).
Add a refreshInterval field with <SelectInterval/> from @components/common/SelectInterval if the config includes refreshInterval.

Examples:

ontrack-web-core/components/widgets/home/LastActiveProjectsWidgetForm.js (simple)
ontrack-web-core/components/widgets/home/FavouriteProjectsWidgetForm.js (no config)
ontrack-web-core/components/widgets/home/BranchStatusesWidgetForm.js (complex with Form.List)

Step 4 — Final checklist

{Name}Widget.kt created with key = "home/{Name}" and @Component
{Name}WidgetConfig data class implements WidgetConfig
{Name}Widget.js created; props match config fields; setTitle called
{Name}WidgetForm.js created; widgetEditionForm used; all Form.Item names match config fields
Verify that the widget key home/{Name} matches the JS file paths ({Name}Widget.js / {Name}WidgetForm.js)

Files

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

Open the folder on GitHubat commit 8b8cd43

Compare with similar skills

Add Widget 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 Widget compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Add Widget this skillyontrack/yontrack	102	—	~1.6k	Automated safety check: Pass	MIT	today
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 Widget

What does Add Widget do?

Scaffold a new Yontrack dashboard widget end-to-end — Kotlin AbstractWidget class with config data class, and two frontend components (display + form). Add Widget is an agent skill from yontrack/yontrack. Scaffold a new Yontrack dashboard widget end-to-end — Kotlin AbstractWidget class with config data class, and two frontend components (display + form).

When should I use Add Widget?

Add Widget fits situations like: asked to create a new dashboard widget; tasks that involve Android development.

How do I install Add Widget in Claude Code?

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

How do I install Add Widget in Codex?

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

Can I use Add Widget 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-widget -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-widget, .gemini/skills/add-widget, .github/skills/add-widget and .opencode/skills/add-widget in your project.

What does Add Widget need to run?

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

Does Add Widget 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 Widget 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 Widget use?

Add Widget 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 Widget use?

About 1.6k tokens (SKILL.md is roughly 6.2k 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 Widget?

Skills that share tags, products or a category with Add Widget: 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 Widget?

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 Widget

Install Add Widget

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-widget — Add a Yontrack Dashboard Widget

Step 1 — Kotlin widget class

Step 2 — Display component

Step 3 — Form component

Step 4 — 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 JSON Schema

Add Property Type

Fix Issue

New Extension

Release Milestone

Run Initiative

Questions about Add Widget

Install Add Widget

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-widget — Add a Yontrack Dashboard Widget

Step 1 — Kotlin widget class

Step 2 — Display component

Step 3 — Form component

Step 4 — Final checklist

Files

Compare with similar skills

Similar skills

More from yontrack/yontrack

Related

Questions about Add Widget