@zaflun/lumio-agent-skill 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zaflun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,65 @@
+# @zaflun/lumio-agent-skill
+
+AI coding assistant knowledge for building [Lumio](https://lumio.vision) extensions. Installs reference files that teach Claude Code, GitHub Copilot, Cursor, Google Gemini, OpenAI Codex, and Windsurf how to use the Lumio SDK.
+
+## Installation
+
+```bash
+npx @zaflun/lumio-agent-skill add
+```
+
+This creates `.lumio/skills/` in your project with reference docs, plus agent config files (`GEMINI.md`, `AGENTS.md`, `.windsurfrules`, `.github/copilot-instructions.md`) in your project root.
+
+## What gets installed
+
+### Skill Files (`.lumio/skills/`)
+
+| File | Content |
+|------|---------|
+| `SKILL.md` | SDK overview, components, hooks, architecture |
+| `components.md` | All 14 UI components with props |
+| `server-functions.md` | Server function patterns, ctx API |
+| `cli-workflows.md` | All 12 CLI commands |
+| `auth.md` | Token types, permissions |
+| `runtime-scopes.md` | Editor/layer/interactive surfaces |
+| `best-practices.md` | Performance, security, UX |
+| `troubleshooting.md` | Common errors and fixes |
+
+### Agent Config Files (project root)
+
+| File | For |
+|------|-----|
+| `GEMINI.md` | Google Gemini CLI |
+| `AGENTS.md` | OpenAI Codex / ChatGPT |
+| `.windsurfrules` | Windsurf |
+| `.github/copilot-instructions.md` | GitHub Copilot |
+
+Claude Code reads `.lumio/skills/SKILL.md` automatically — no config file needed.
+
+## What your AI assistant learns
+
+- 3-layer sandbox architecture (Supervisor → Runtime → Worker)
+- 14 SDK components with typed props
+- 10 hooks (`useLumioEvent`, `useLumioAction`, `useExtensionStorage`, ...)
+- 49 event types across 5 platforms
+- 21 action types (chat, OBS, Spotify, overlay)
+- Server function patterns (declarative CRUD + handler-based)
+- CLI workflows (init → dev → build → deploy)
+- Publishing lifecycle (draft → review → testing → published)
+
+## Updating
+
+```bash
+npx @zaflun/lumio-agent-skill add
+```
+
+Re-running overwrites skill files with the latest version. Safe to run multiple times.
+
+## Documentation
+
+- [AI Assistant Guide](https://developers.lumio.vision/guides/ai-assistant)
+- [Full Docs](https://developers.lumio.vision)
+
+## License
+
+MIT © [zaflun](https://withzaflun.com)

package/dist/bin/lumio-skills.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/lumio-skills.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import {
+  installSkillFiles
+} from "../chunk-I2USQPPS.js";
+
+// src/bin/lumio-skills.ts
+import { resolve } from "path";
+var args = process.argv.slice(2);
+var command = args[0];
+if (command === "add") {
+  const targetDir = resolve(process.cwd());
+  console.log("Installing Lumio Extension skill files...");
+  installSkillFiles(targetDir);
+  console.log("");
+  console.log("Installed skill files to .lumio/skills/:");
+  console.log("  SKILL.md              - Architecture overview + quick reference");
+  console.log("  components.md         - All 14 SDK components with props + examples");
+  console.log("  server-functions.md   - Declarative + handler-based server functions");
+  console.log("  cli-workflows.md      - All 8 CLI commands with examples");
+  console.log("  auth.md               - Token types, scopes, editorOnly");
+  console.log("  runtime-scopes.md     - instance/overlay/account/global scopes");
+  console.log("  best-practices.md     - Performance + UX patterns");
+  console.log("  troubleshooting.md    - Common errors + fixes");
+  console.log("");
+  console.log("AI agents will automatically load these files for context.");
+} else {
+  console.log("Usage: npx lumio-skills add");
+  console.log("");
+  console.log("Installs Lumio Extension SDK skill files for AI coding assistants.");
+  process.exit(1);
+}