dotframe 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.2
+
+- `npx skills add crafter-games/dotframe` installs a `dotframe` discovery skill that points agents at `dotframe skills get core`. The guides served by the CLI moved to `skill-data/`, so they are not installed as separate skills.
+
 ## 0.1.1
 
 - First release published from CI through npm trusted publishing, with provenance.

package/README.md

@@ -9,7 +9,8 @@ Status: S5 in progress (porting Crafter Smash). `examples/canvas2d` exercises `s
 `dotframe` is an agent-first CLI over the engine. The simulation is deterministic, so an agent can play a game without a screen, render a frame with the real renderer, and catch netplay desyncs before a real match.
 
 ```sh
-bun link                                    # or: bun add -g github:crafter-games/dotframe
+npm i -g dotframe                           # needs Bun on PATH
+npx skills add crafter-games/dotframe      # installs the agent skill stub
 dotframe new my-game --template fighter     # fighter, platformer, blank
 dotframe sim --mash 7 --frames 600 --json   # headless run: state + checksum
 dotframe snap --frame 300 --mash 7          # one frame through WebGPU (agent-browser)
@@ -23,7 +24,7 @@ dotframe skills list                        # guides bundled with this version
 
 A game opts in with a `dotframe.json` (targets, deploy, relay, vendor links, local-only assets) and a `sim` module that default-exports `defineSim` from `src/sim.ts`. Agents start with `dotframe skills get core`. Every command takes `--json`; errors carry a `code`, a `fix`, and the `skill` to read.
 
-- `cli/`: the CLI (Bun). `skills/`: the guides served by `dotframe skills`. `templates/`: the `dotframe new` templates.
+- `cli/`: the CLI (Bun). `skill-data/`: the guides served by `dotframe skills`. `skills/dotframe`: the discovery stub that `npx skills add crafter-games/dotframe` installs. `templates/`: the `dotframe new` templates.
 
 ## Layout
 

package/cli/commands/new.ts

@@ -3,13 +3,6 @@ import { join, resolve } from "node:path";
 import { CliError, type Ctx, exec, loadConfig, print, runSteps, target } from "../lib";
 
 const TEMPLATES = resolve(import.meta.dir, "../../templates");
-const STUB = `---
-name: dotframe
-description: Build, test, and export this dotframe game. Use when changing gameplay, simulating or replaying frames, checking a render, debugging netplay desyncs, or building and deploying a target.
----
-Run \`dotframe skills get core\` before any dotframe command. It matches the installed CLI version.
-List the specialized guides with \`dotframe skills list\`.
-`;
 
 export async function create(ctx: Ctx, name: string | undefined, template: string, install = true): Promise<void> {
   if (!name || !/^[a-z0-9][a-z0-9-]*$/.test(name)) throw new CliError("BAD_NAME", "new needs a lowercase name (letters, digits, dashes)", "dotframe new my-game --template fighter", "game-design");
@@ -30,7 +23,7 @@ export async function create(ctx: Ctx, name: string | undefined, template: strin
     writeFileSync(join(dir, to), readFileSync(from, "utf8").replaceAll("__NAME__", name).replaceAll("__SCOPE__", "your-vercel-team"));
   }
   mkdirSync(join(dir, ".agents/skills/dotframe"), { recursive: true });
-  writeFileSync(join(dir, ".agents/skills/dotframe/SKILL.md"), STUB);
+  cpSync(resolve(import.meta.dir, "../../skills/dotframe/SKILL.md"), join(dir, ".agents/skills/dotframe/SKILL.md"));
   mkdirSync(join(dir, "replays"), { recursive: true });
   const steps = [
     { label: "git init", argv: ["git", "init", "-q"] },

package/cli/commands/skills.ts

@@ -4,7 +4,7 @@ import { CliError, type Ctx, print } from "../lib";
 
 // Skills ship inside the dotframe package, so the guide always matches the installed CLI.
 export function skillsDir(): string {
-  return resolve(process.env.DOTFRAME_SKILLS_DIR ?? join(import.meta.dir, "../../skills"));
+  return resolve(process.env.DOTFRAME_SKILLS_DIR ?? join(import.meta.dir, "../../skill-data"));
 }
 
 interface Skill {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotframe",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "TS-first game engine and agent-first CLI: one codebase for web, Discord, iOS and native binaries",
   "license": "MIT",
   "type": "module",
@@ -16,7 +16,7 @@
   "files": [
     "cli",
     "src",
-    "skills",
+    "skill-data",
     "templates",
     "assets",
     "tools/*.ts",
@@ -24,11 +24,12 @@
     "scripts",
     "README.md",
     "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "skills"
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/crafter-games/dotframe"
+    "url": "git+https://github.com/crafter-games/dotframe.git"
   },
   "homepage": "https://github.com/crafter-games/dotframe#readme",
   "keywords": [

package/skills/dotframe/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: dotframe
+description: Agent-first CLI for the dotframe game engine. Use when building, testing, or exporting a dotframe game: creating a game from a template, simulating or replaying frames headless, rendering a frame to check what a player sees, debugging rollback netplay desyncs, or building and deploying for web, Discord Activities, iOS, and native macOS or Windows. Triggers include "make a game", "dotframe", "simulate the match", "snap a frame", "replay", "desync", "netplay", "build for iOS", "deploy the game", or any repo with a dotframe.json.
+allowed-tools: Bash(dotframe:*), Bash(npx dotframe:*), Bash(bunx dotframe:*)
+hidden: true
+---
+
+# dotframe
+
+TypeScript game engine with an agent-first CLI. The simulation is deterministic, so an agent can play a game without a screen, render one frame through the real WebGPU renderer, and catch netplay desyncs before a real match.
+
+Install: `npm i -g dotframe` (needs Bun on PATH)
+
+## Start here
+
+This file is a discovery stub, not the usage guide. Before running any `dotframe` command, load the actual workflow content from the CLI:
+
+```bash
+dotframe skills get core             # start here: the edit, sim, snap, replay loop, the Sim contract, the trust ladder
+dotframe skills get core --full      # include the full error code reference
+```
+
+The CLI serves skill content that always matches the installed version, so instructions never go stale. The content in this stub cannot change between releases, which is why it just points at `skills get core`.
+
+## Specialized skills
+
+Load a specialized skill when the task calls for it:
+
+```bash
+dotframe skills get netplay        # rollback netcode, desync, render purity
+dotframe skills get game-design    # new games, templates, shaping state for agents
+dotframe skills get export-web     # web build, local dev, Vercel deploys
+dotframe skills get discord        # Discord Activities, URL mappings, stale bundles
+dotframe skills get ios            # iPhone builds, vendor links, signing, device install
+dotframe skills get macos          # native binaries with scriptc
+dotframe skills get relay          # relay placement and deploys
+dotframe skills get assets         # licensing and local-only assets before a release
+```
+
+Run `dotframe skills list` to see everything available on the installed version. Errors in `--json` mode name the skill to read in their `skill` field.