git:20261031.8082cab to git:20261031.75f4661

4 added, 0 removed. Audit A to A.

# Emdash Skills — Agent Instructions

This repository contains 23 skill categories, 28 agents, and 149 reference docs for autonomous product building.

+ ## Scoped shared-platform mandate (2026-10-31)

+ For OnePrompt.site/ProjectSites.dev, theme.tools/ui.theme.tools, desktop.management, Inbox.vision, pdf.kitchen and their shared infrastructure, load [rules/platform-shared-capabilities.md](rules/platform-shared-capabilities.md) before older stack defaults, then its relevant modules. The [platform pack](_packs/platform.yml) and [execution prompt](prompts/platform-convergence.md) require Bolt.diy, Cloudflare Agents, AG-UI, json-render, MCP Apps, Better Auth, AI Search instead of QMD, PlateJS, React Flow, Remotion, Infisical Agent Vault, shared connectors and automation. These scoped decisions supersede conflicting defaults below; preserve unrelated policies and migrate safely. Apply them during `/run-the-loop`, retain explicit Figma approval, and distinguish committed policy from verified product functionality and acknowledged consumer sync.

## Stack

## Canonical UI and approval (HARD RULE)

For every UI, component, Storybook, theme, Figma, OnePrompt, or ProjectSites task, first read [rules/theme-tools-canonical-components.md](rules/theme-tools-canonical-components.md). Every visual component is sourced, edited, updated, managed, tested, and published through the source repository backing **ui.theme.tools**; **theme.tools** owns starting themes/tokens. Consume pinned packages, not local forks or mutable hosted scripts. This supersedes older draftl.ink and per-app copied-component defaults. Guide Brian through explicit Figma approval per screen or for the complete design before programming new/materially changed UI. A general request to implement everything is not design approval. OnePrompt requires Cloudflare, PostHog, Sentry, GA4, GTM, Langfuse Cloud, and Promptfoo, with verified delivery rather than merely installed SDKs. Use manifest-first progressive previews and smallest-sufficient, authorized stack patches; keep generated previews isolated.

## Internal Agent Providers (HARD RULE)

Internal dev/research/agent-orchestration runs on **subscription CLIs** (`claude` + `codex`) for frontier judgment and **DeepSeek-via-OpenCode** (`bin/opencode-deepseek.sh`) for throughput — NEVER the `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` paid APIs to make a model research/plan/review/write code when a CLI can do it. Launch every internal CLI via `bin/with-subscription-cli.sh` (a child `claude` must not inherit `ANTHROPIC_API_KEY`; a child `codex` must not inherit `OPENAI_API_KEY` — either overrides the subscription and bills). Customer-facing OpenAI/Anthropic PRODUCT features are a separate, preserved, platform-billed axis. SSOT: `rules/agent-provider-policy.md`.

## Usage

For recurring development and local host operations, read [control-plane/FLEET.md](control-plane/FLEET.md) and the matching profile under `machines/`. GitHub owns the per-project schedule; the persistent Ubuntu Proxmox VM is the primary host and prefers Codex for setup. OpenClaw orchestrates official subscription CLIs through Claw Router and direct OpenCode/DeepSeek. Main is normal; feature branches are exceptional. Do not schedule this skills repository.

Load skills on demand via the skill router (`_router.md`). Each category has a `SKILL.md` with submodules listed in frontmatter.

## Key Files

- `CONVENTIONS.md` — shared constants, patterns, stack config

- `_router.md` — routes prompts to smallest useful skill subset

- `SKILL_PROFILES.md` — default bundles by product type (SaaS, API, Marketing, etc.)

- `llms.txt` — LLM-optimized index of all skills

## For AI Coding Tools

This repo is compatible with the agentskills.io open standard. Skills work in Claude Code, OpenAI Codex, Cursor, GitHub Copilot, VS Code, Windsurf, Augment, OpenHands, Gemini CLI, and 30+ other tools.

## Platform Variants (30 total)

Install: `claude plugin install heymegabyte/agent-skills`

Codex: Clone into `~/.codex/skills/` or `.agents/skills/`

npm: `npm i @heymegabyte/agent-skills`