# Miniapp

Build a tiny interactive HTML playground only when someone asks to see, play with, or...

- Repository: https://github.com/yc-software/qm (15597 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add yc-software/qm --skill miniapp -g -a claude-code -y`
Codex: `npx skills add yc-software/qm --skill miniapp -g -a codex -y`
Cursor: `npx skills add yc-software/qm --skill miniapp -g -a cursor -y`
Gemini CLI: `npx skills add yc-software/qm --skill miniapp -g -a gemini-cli -y`

## Description

Build a tiny interactive HTML playground only when someone asks to see, play with, or step through a mechanism.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Miniapp

In a web conversation, use the `miniapp` tool for a focused, one-screen interactive explanation, simulation, or small game. The tool is intentionally unavailable on surfaces that cannot render playground artifacts.

- Keep HTML, CSS, and JavaScript self-contained.
- Do not use network requests, external assets, modules, or servers.
- Make controls keyboard-accessible and label them clearly.
- Let the document choose its own presentation; the host will not rewrite it.
- Do not put a marker or artifact URL in the reply. The client attaches the playground from the typed tool result.
- Use `apps` action `publish` instead when the app needs persistence, a server, or multiple routes.