mcpField
W
widgets

widgets

github.com/iskron-aiAgent workflows240 installsUpdated 1d ago
Repository

About widgets

widgets is a skill for displaying live graph data in Искрона windows, aimed at people who need to inspect cases or active agents in context. It defines `iskron` blocks for case lists, individual case cards, and active agents.

Key features

  1. 01Declare widgets in `iskron` blocks
  2. 02Show graph case lists
  3. 03Display an individual case status
  4. 04List active agents and their open cases
  5. 05Respect graph and access permissions

Use cases

  1. 01Review open or closed cases in a graph
  2. 02Check the current state of a specific case
  3. 03See which agents are active in a graph

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/iskron-ai/skills --skill widgets

After installing, type/widgetsin Claude Code to confirm it loaded.

Details

From the project README

Виджеты окна Искрона

Виджет — огороженный блок кода с меткой iskron. Тело — ровно одна строка: имя виджета, следом в той же строке параметры ключ=значение через пробел, больше ничего. Окно рисует на месте блока живой вид данных графа; блок с другой меткой остаётся кодом.

  • Граф — всегда явно: realm=rN, короткий id графа, тот же, что в ссылках «rN#N»; полный адрес из iskron_realm(action="list") — только если другой формы ты не видел. Граф не установлен — блок не ставь, скажи словами: без realm окно покажет плашку «укажите граф».
  • Данные виджет читает сам в миг показа: не собирай список дел или агентов и не пересказывай его рядом. Что в деле затык и почему — пишется словами рядом с виджетом.
  • Канонические формы — case №N, node=#N: окно терпит и case N, node=N, но пиши канон.
  • Незнакомое имя или параметр — спокойная плашка, не ошибка; граф закрыт читающему — плашка «закрыто». Поверхность, не знающая договора (бот, чужой рендерер), показывает блок кодом — там виджет не ставь.

Пример блока:

cases realm=rN status=open

cases — живой список дел графа

Когда: человек спрашивает, какие дела идут, открыты или закрыты в графе или по узлу, — вместо того, чтобы пересказывать дела списком.

Форма: cases realm=rN status=open node=#N

  • realm обязателен: короткий id графа (rN) или @owner/slug;
  • status — open (по умолчанию), closed или all;
  • node — только дела в охвате узла, включая вложенные; без него — весь граф.

Пример:

cases realm=rN status=open

Человек увидит: заголовок со статусом и узлом, строки дел — «№N зачин» ссылкой на дело, статус, ведущий, время последней строки; дело, скрытое доступом, — номер без ссылки. Данные свежие на момент показа.

case — карточка одного дела

Когда: речь идёт о конкретном деле, и человеку нужно видеть, где оно стоит, — вместо пересказа его состояния. Просто упомянуть дело в тексте — хватит ссылки «№N».

Форма: case №N realm=rN

  • №N — номер дела в этом графе;
  • realm обязателен: rN или @owner/slug.

Пример:

case №26 realm=rN

Человек увидит: зачин дела ссылкой, статус, ведущий и время последней строки; нет дела или оно закрыто читающему — спокойная строка об этом.

agents — активные агенты графа и их открытые дела

Когда: спрашивают, кто сейчас работает в графе, какие агенты активны, кто чем занят и в каких делах — вместо пересказа доски.

Форма: agents realm=rN

  • realm обязателен: rN или @owner/slug.

Пример:

agents realm=rN

Человек увидит: места на рабочих ролях (能) — адрес места, роль, живость, строка занятости и открытые дела каждого (дела читаются у первых шести мест). Места владельческих ролей (主) — человек и то, что говорит за него, — в список не входят. Доску мест видят те, кто может писать в граф; остальные видят «закрыто».

Comments

Markdown supported