chatkit-actions SKILL.md skillA

chatkit-actions from mjunaidca/mjs-agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mjunaidca/mjs-agent-skills/chatkit-actions@git:20251221.f6c90d7

Pins git:20251221.f6c90d7 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mjunaidca/mjs-agent-skills
Path
docs/taskflow-vault/skills/engineering/chatkit-actions/SKILL.md
Versions recorded
1
Latest version
git:20251221.f6c90d7, committed Dec 21, 2025
Size
23,080 bytes
Repository stars
28
License
none declared

Implements interactive widget actions and bidirectional communication patterns for ChatKit. This skill should be used when building AI-driven interactive UIs with buttons, forms, entity tagging (@mentions), composer tools, and server-handled widget actions. Covers the full widget lifecycle from creation to replacement.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# ChatKit Actions Skill

## Overview

This skill unlocks the full power of ChatKit's agentic UI capabilities - where AI can render interactive widgets, users can click buttons that trigger both client and server actions, and the conversation becomes a two-way interactive experience.

## Core Concepts

### Action Handler Types

Widgets can specify where actions are handled:

| Handler | Defined In | Processed By | Use Case |
|---------|------------|--------------|----------|
| `"client"` | Widget template | Frontend `onAction` | Navigation, local state, send follow-up |
| `"server"` | Widget template | Backend `action()` method | Data mutation, widget replacement |

### Widget Lifecycle

```
1. Agent tool generates widget → yield WidgetItem
2. Widget renders in chat with action buttons
3. User clicks action → action dispatched
4. Handler processes action:
   - client: onAction callback in frontend
   - server: action() method in ChatKitServer
5. Optional: Widget replaced with updated state
```

## Implementation Patterns

### Pattern 1: Widget Templates (.widget files)

**When**: Define reusable widget layouts with dynamic data

**Widget Template Format**:
```json
{
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mjunaidca/mjs-agent-skills/chatkit-actions@sha256:d1b4740a260ecea2

The line at the top of this page pins the label git:20251221.f6c90d7, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_2u5c25odksaoc3ee.svg)](https://markdownregistry.com/a/art_2u5c25odksaoc3ee)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Dec 21, 2025.

versioncommittedcommitsizeaudit
git:20251221.f6c90d7 latest2025-12-21 f6c90d7 23,080 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (23080 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

mjunaidca/mjs-agent-skills · 28 stars · license none declared · pushed 2026-08-12 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2u5c25odksaoc3ee
GET https://markdownregistry.com/api/v1/resolve?ref=mjunaidca/mjs-agent-skills/chatkit-actions
GET https://markdownregistry.com/api/v1/blob/d1b4740a260ecea20ab98d705bc57d8bcbdbcb91505ce7775e3c434d180eff6b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from mjunaidca/mjs-agent-skills

browsing-with-playwright SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/browsing-with-playwright/SKILL.md · Browser automation using Playwright MCP. Navigate websites, fill forms, click elements, take screenshots, and extract…
git:20251221.180758f · audit A · 28 stars
building-chat-interfaces SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/building-chat-interfaces/SKILL.md · Build AI chat interfaces with custom backends, authentication, and context injection. Use when integrating chat UI with…
git:20251222.3cc0c3c · audit B · 28 stars
building-chat-widgets SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/building-chat-widgets/SKILL.md · Build interactive AI chat widgets with buttons, forms, and bidirectional actions. Use when creating agentic UIs with…
git:20251222.3cc0c3c · audit A · 28 stars
building-chatgpt-apps SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/building-chatgpt-apps/SKILL.md · Guides creation of ChatGPT Apps with interactive widgets using OpenAI Apps SDK and MCP servers. Use when building…
git:20251222.ace8bd5 · audit F · 28 stars
building-mcp-servers SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/building-mcp-servers/SKILL.md · Guides creation of high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external…
git:20251221.e60e67d · audit A · 28 stars
building-nextjs-apps SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/building-nextjs-apps/SKILL.md · Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic…
git:20251222.3cc0c3c · audit A · 28 stars
building-rag-systems SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/building-rag-systems/SKILL.md · Build production RAG systems with semantic chunking, incremental indexing, and filtered retrieval. Use when…
git:20251222.1a21d20 · audit A · 28 stars
configuring-better-auth SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/configuring-better-auth/SKILL.md · Implement OAuth 2.1 / OIDC authentication using Better Auth with MCP assistance. Use when setting up a centralized auth…
git:20251222.3cc0c3c · audit A · 28 stars
creating-skills SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/creating-skills/SKILL.md · Guides creation of effective Agent Skills with proper structure and validation. Use when users want to create a new…
git:20251222.8a87f42 · audit A · 28 stars
docker SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/docker/SKILL.md · Production-grade Docker containerization for Python and Node.js applications. This skill should be used when users ask…
git:20260124.14c9905 · audit A · 28 stars
evaluation SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/evaluation/SKILL.md · Build evaluation frameworks for agent systems. Use when testing agent performance, validating context engineering…
git:20251222.04068a4 · audit A · 28 stars
fetching-library-docs SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/fetching-library-docs/SKILL.md · Token-efficient library API documentation fetcher using Context7 MCP with 77% token savings. Fetches code examples, API…
git:20251222.3cc0c3c · audit A · 28 stars

Every file in mjunaidca/mjs-agent-skills

Browse by kind, by grade A, or by owner.