building-chat-interfaces SKILL.md skillB

building-chat-interfaces 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/building-chat-interfaces@git:20251222.3cc0c3c

Pins git:20251222.3cc0c3c in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
mjunaidca/mjs-agent-skills
Path
.claude/skills/building-chat-interfaces/SKILL.md
Versions recorded
1
Latest version
git:20251222.3cc0c3c, committed Dec 22, 2025
Size
9,734 bytes
Repository stars
28
License
none declared

Build AI chat interfaces with custom backends, authentication, and context injection. Use when integrating chat UI with AI agents, adding auth to chat, injecting user/page context, or implementing httpOnly cookie proxies. Covers ChatKitServer, useChatKit, and MCP auth patterns. NOT when building simple chatbots without persistence or custom agent integration.

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

# Building Chat Interfaces

Build production-grade AI chat interfaces with custom backend integration.

## Quick Start

```bash
# Backend (Python)
uv add chatkit-sdk agents httpx

# Frontend (React)
npm install @openai/chatkit-react
```

---

## Core Architecture

```
Frontend (React)                    Backend (Python)
┌─────────────────┐                ┌─────────────────┐
│  useChatKit()   │───HTTP/SSE───>│  ChatKitServer  │
│  - custom fetch │                │  - respond()    │
│  - auth headers │                │  - store        │
│  - page context │                │  - agent        │
└─────────────────┘                └─────────────────┘
```

---

## Backend Patterns

### 1. ChatKit Server with Custom Agent

```python
from chatkit.server import ChatKitServer
from chatkit.agents import stream_agent_response
from agents import Agent, Runner

class CustomChatKitServer(ChatKitServer[RequestContext]):
    """Extend ChatKit server with custom agent."""

    async def respond(
        self,
        thread: ThreadMetadata,
        input_user_message: UserMessageItem | None,
        context: RequestContext,
    ) -> AsyncIterator[ThreadStreamEvent]:
        if not input_user_message:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mjunaidca/mjs-agent-skills/building-chat-interfaces@sha256:8d763134836205ec

The line at the top of this page pins the label git:20251222.3cc0c3c, 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_xp266kispfazjwdv.svg)](https://markdownregistry.com/a/art_xp266kispfazjwdv)

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

Versions

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

versioncommittedcommitsizeaudit
git:20251222.3cc0c3c latest2025-12-22 3cc0c3c 9,734 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No script tag (matched: <Script)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9734 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

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

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_xp266kispfazjwdv
GET https://markdownregistry.com/api/v1/resolve?ref=mjunaidca/mjs-agent-skills/building-chat-interfaces
GET https://markdownregistry.com/api/v1/blob/8d763134836205ec9d6f54c7bd1596ad874cd97e91f0790a2a0d49333898ceae

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-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
helm SKILL.md skill
mjunaidca/mjs-agent-skills · .claude/skills/helm/SKILL.md · Production-grade Helm 4 chart development, release management, and debugging. This skill should be used when users ask…
git:20260124.14c9905 · audit A · 28 stars

Every file in mjunaidca/mjs-agent-skills

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