@blazium-games/skills 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/GROK.md +32 -0
  2. package/README.md +26 -2
  3. package/SKILL_TREE.md +60 -0
  4. package/package.json +3 -1
  5. package/skills/blazium-games-analytics/SKILL.md +2 -1
  6. package/skills/blazium-games-deploy/SKILL.md +1 -1
  7. package/skills/blazium-games-player/SKILL.md +1 -1
  8. package/skills/blazium-games-player/references/tools.md +1 -1
package/GROK.md ADDED
@@ -0,0 +1,32 @@
1
+ # Grok host — Blazium Games skills
2
+
3
+ How Grok should load these skills. Same files as Claude, Cursor, and Codex. No invented marketplace schema.
4
+
5
+ These skills are for the store at [blazium.games](https://blazium.games). They are not the Blazium engine skills.
6
+
7
+ Read [SKILL_TREE.md](SKILL_TREE.md) for which skill to use. The guide is [docs.blazium.games](https://docs.blazium.games), and the short map is [llms.txt](https://docs.blazium.games/llms.txt). Do not invent platform behavior that those pages do not describe.
8
+
9
+ ## Install
10
+
11
+ Grok routes on each skill's YAML `description`. It reads `SKILL.md` from a skills directory. Grok also auto-reads Claude Code marketplaces, plugins, and skills, so `.claude-plugin/marketplace.json` works when that plugin layout is present. A symlink into `./.grok/skills/` or `~/.grok/skills/` is the explicit path when you are not loading the Claude plugin.
12
+
13
+ From a clone of this repo:
14
+
15
+ ```bash
16
+ python scripts/sync_packs.py
17
+ python scripts/validate_packs.py
18
+ ```
19
+
20
+ | Method | What to do |
21
+ |--------|------------|
22
+ | Project skills | Symlink or copy `skills/<name>/` into the workspace skills root Grok already lists |
23
+ | User skills | Symlink `skills/` into `~/.grok/skills/` |
24
+ | Claude plugin | Leave `.claude-plugin/marketplace.json` in place. Grok reads it automatically |
25
+
26
+ Do not invent `.grok-plugin/marketplace.json`. If a future Grok marketplace lands, register the existing Claude catalog paths. Do not fork the skill bodies.
27
+
28
+ ## Plugins
29
+
30
+ - `blazium-games-developer` — publishing
31
+ - `blazium-games-player` — playing and buying
32
+ - `blazium-games` — both, plus the developer and player MCP servers
package/README.md CHANGED
@@ -2,9 +2,33 @@
2
2
 
3
3
  Agent skills for [Blazium Games](https://blazium.games), the store operated by Divine Games, Inc. They cover store pages, deploys, crash reporting, analytics, keys, and playing or buying games.
4
4
 
5
- This package is the store. It is not the engine skills at [`@blazium-engine/skills`](https://www.npmjs.com/package/@blazium-engine/skills), and it does not install Hub, the engine CLI, or the toolchain. A game on Blazium Games does not have to be made with the Blazium engine.
5
+ This package is the store. It is not the engine skills at [`@blazium-engine/skills`](https://www.npmjs.com/package/@blazium-engine/skills), and it does not install Hub, the engine CLI, or the toolchain. A game on Blazium Games does not have to be made with the Blazium engine. The upload command is `chauffeur` from [`@blazium-games/cli`](https://www.npmjs.com/package/@blazium-games/cli).
6
6
 
7
- The guide and the in-repo Cursor plugin source stay in [games_docs](https://github.com/blazium-games/games_docs). This repo is the versioned release.
7
+ The guide and the in-repo Cursor plugin source stay in [games_docs](https://github.com/blazium-games/games_docs). This repo is the versioned release. The skill index, with links into the guide, is [SKILL_TREE.md](SKILL_TREE.md).
8
+
9
+ ## Documentation
10
+
11
+ Read these before guessing how the platform works:
12
+
13
+ - [docs.blazium.games](https://docs.blazium.games)
14
+ - Docs map: [llms.txt](https://docs.blazium.games/llms.txt)
15
+ - Platform map: [blazium.games/llms.txt](https://blazium.games/llms.txt)
16
+ - [Discovery files](https://docs.blazium.games/docs/discovery)
17
+ - [Introduction](https://docs.blazium.games/docs/intro)
18
+
19
+ | Skill | Guide |
20
+ |-------|--------|
21
+ | `blazium-games-get-started` | [MCP](https://docs.blazium.games/docs/mcp), [OAuth](https://docs.blazium.games/docs/mcp/oauth), [Cursor plugin](https://docs.blazium.games/docs/cursor-plugin) |
22
+ | `blazium-games-store-page` | [Listings](https://docs.blazium.games/docs/listings), [Content rules](https://docs.blazium.games/docs/content-rules), [Press kit](https://docs.blazium.games/docs/press-kit), [Images](https://docs.blazium.games/docs/graphical_assets_guidelines), [Selling](https://docs.blazium.games/docs/payments/selling) |
23
+ | `blazium-games-deploy` | [Deploy builds](https://docs.blazium.games/docs/deploy), [chauffeur CLI](https://docs.blazium.games/docs/cli) |
24
+ | `blazium-games-crash-reporting` | [Crash reporting](https://docs.blazium.games/docs/crash-reporting) |
25
+ | `blazium-games-debug-crash` | [Reading crashes](https://docs.blazium.games/docs/crash-reporting#reading-crashes) |
26
+ | `blazium-games-analytics` | [Download analytics](https://docs.blazium.games/docs/download-analytics) |
27
+ | `blazium-games-keys` | [Access and keys](https://docs.blazium.games/docs/mcp/access-and-keys) |
28
+ | `blazium-games-player` | [Player MCP](https://docs.blazium.games/docs/mcp/player) |
29
+ | `blazium-games-purchases` | [Agent purchases](https://docs.blazium.games/docs/payments/agent-purchases) |
30
+
31
+ Support is [blazium.games/support](https://blazium.games/support). Status is [status.blazium.games](https://status.blazium.games). Platform bugs go to [blazium-games/support](https://github.com/blazium-games/support/issues).
8
32
 
9
33
  ## Install
10
34
 
package/SKILL_TREE.md ADDED
@@ -0,0 +1,60 @@
1
+ # Blazium Games skill tree
2
+
3
+ Blazium Games is the platform for playing and publishing games, applications, mods, and assets. A token belongs to one server: `blazium-games` (developer, `https://mcp.blazium.games/mcp`, keys `bgames_mcp_`) publishes pages, builds, crashes, analytics, and keys. `blazium-games-player` (player, `https://mcp.blazium.games/player`, keys `bgames_play_`) finds, reviews, installs, and buys.
4
+
5
+ The guide is [docs.blazium.games](https://docs.blazium.games). This file is the skill index. The docs site remains the source for how the platform works.
6
+
7
+ ## Read this first
8
+
9
+ - Docs map: https://docs.blazium.games/llms.txt
10
+ - Platform map: https://blazium.games/llms.txt
11
+ - Which files exist, and which do not: https://docs.blazium.games/docs/discovery
12
+ - Introduction: https://docs.blazium.games/docs/intro
13
+ - Developer server card: https://mcp.blazium.games/.well-known/mcp/server-card.json
14
+ - Player server card: https://mcp.blazium.games/.well-known/mcp/player-server-card.json
15
+
16
+ ## Start here
17
+
18
+ New to Blazium Games? Start with [blazium-games-get-started](skills/blazium-games-get-started/SKILL.md). It connects the right server, verifies the account, and routes to the skill that matches the goal. The plugin guide is [Cursor plugin](https://docs.blazium.games/docs/cursor-plugin).
19
+
20
+ ## Skills
21
+
22
+ | Skill | Use it to | Docs |
23
+ |-------|-----------|------|
24
+ | [blazium-games-get-started](skills/blazium-games-get-started/SKILL.md) | Connect, verify, and pick a workflow | [MCP](https://docs.blazium.games/docs/mcp), [OAuth](https://docs.blazium.games/docs/mcp/oauth), [Cursor plugin](https://docs.blazium.games/docs/cursor-plugin) |
25
+ | [blazium-games-store-page](skills/blazium-games-store-page/SKILL.md) | Create or edit a store page, set a price or donations, fill the press kit | [Listings](https://docs.blazium.games/docs/listings), [Content rules](https://docs.blazium.games/docs/content-rules), [Press kit](https://docs.blazium.games/docs/press-kit), [Images](https://docs.blazium.games/docs/graphical_assets_guidelines), [Media CLI](https://docs.blazium.games/docs/cli/media), [Selling](https://docs.blazium.games/docs/payments/selling) |
26
+ | [blazium-games-deploy](skills/blazium-games-deploy/SKILL.md) | Ship builds from CI or `npm install -g @blazium-games/cli` | [Deploy builds](https://docs.blazium.games/docs/deploy), [CLI](https://docs.blazium.games/docs/cli), [CI](https://docs.blazium.games/docs/cli/ci) |
27
+ | [blazium-games-crash-reporting](skills/blazium-games-crash-reporting/SKILL.md) | Send crashes and events from a game | [Crash reporting](https://docs.blazium.games/docs/crash-reporting), [Symbols](https://docs.blazium.games/docs/cli/symbols) |
28
+ | [blazium-games-debug-crash](skills/blazium-games-debug-crash/SKILL.md) | Triage crashes and map them to code | [Reading crashes](https://docs.blazium.games/docs/crash-reporting#reading-crashes) |
29
+ | [blazium-games-analytics](skills/blazium-games-analytics/SKILL.md) | Summarize page traffic and downloads | [Download analytics](https://docs.blazium.games/docs/download-analytics), [MCP reference](https://docs.blazium.games/docs/mcp/reference) |
30
+ | [blazium-games-keys](skills/blazium-games-keys/SKILL.md) | Inspect and rotate MCP and deploy keys | [Access and keys](https://docs.blazium.games/docs/mcp/access-and-keys), [Permissions](https://docs.blazium.games/docs/legal/permissions) |
31
+ | [blazium-games-player](skills/blazium-games-player/SKILL.md) | Recommendations, catalog search, reviews, bug reports, friends, launcher links, and game chat | [Player MCP](https://docs.blazium.games/docs/mcp/player) |
32
+ | [blazium-games-purchases](skills/blazium-games-purchases/SKILL.md) | Buy, donate, and top up within a spending limit | [Agent purchases](https://docs.blazium.games/docs/payments/agent-purchases), [Top up](https://docs.blazium.games/docs/payments/top-up), [Buying](https://docs.blazium.games/docs/payments/buying) |
33
+
34
+ ## Typical paths
35
+
36
+ - **New game:** get-started, store-page, deploy, crash-reporting
37
+ - **Sell a game:** store-page, deploy. Selling rules: https://docs.blazium.games/docs/payments/selling
38
+ - **Buy a game:** player, purchases
39
+ - **Existing game, new build:** deploy, crash-reporting
40
+ - **Players report crashes:** debug-crash
41
+ - **Find something to play:** player
42
+ - **Leaked key:** keys
43
+
44
+ ## More of the guide
45
+
46
+ - [Developer mode](https://docs.blazium.games/docs/developer-mode)
47
+ - [Public API](https://docs.blazium.games/docs/api-reference)
48
+ - [Payments](https://docs.blazium.games/docs/payments)
49
+ - [Account security](https://docs.blazium.games/docs/account-security)
50
+ - [Linked accounts](https://docs.blazium.games/docs/linked-accounts)
51
+ - [DMCA](https://docs.blazium.games/docs/storefront/dmca)
52
+ - [Report a page](https://docs.blazium.games/docs/storefront/report)
53
+
54
+ ## References in this repo
55
+
56
+ - [Tools](skills/blazium-games-get-started/references/tools.md)
57
+ - [Resources](skills/blazium-games-get-started/references/resources.md)
58
+ - [Prompts](skills/blazium-games-get-started/references/prompts.md)
59
+ - [Authentication](skills/blazium-games-get-started/references/auth.md)
60
+ - Player tools: [tools.md](skills/blazium-games-player/references/tools.md)
package/package.json CHANGED
@@ -1,12 +1,14 @@
1
1
  {
2
2
  "name": "@blazium-games/skills",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Agent skills for the Blazium Games platform.",
5
5
  "repository": "https://github.com/blazium-games/games_skill",
6
6
  "license": "MIT",
7
7
  "files": [
8
8
  "skills",
9
9
  "README.md",
10
+ "SKILL_TREE.md",
11
+ "GROK.md",
10
12
  "LICENSE"
11
13
  ],
12
14
  "publishConfig": {
package/skills/blazium-games-analytics/SKILL.md CHANGED
@@ -54,4 +54,5 @@ For crash trends, use `blazium-games-debug-crash` instead.
54
54
 
55
55
  ## Docs
56
56
 
57
- https://docs.blazium.games/docs/mcp/reference
57
+ - https://docs.blazium.games/docs/download-analytics
58
+ - https://docs.blazium.games/docs/mcp/reference
package/skills/blazium-games-deploy/SKILL.md CHANGED
@@ -20,7 +20,7 @@ Register a build, upload its files, and keep the returned `build_id` for crash r
20
20
  - The `blazium-games` MCP server is connected with write access (see `blazium-games-get-started`)
21
21
  - A store page exists. If not, run `blazium-games-store-page` first
22
22
  - The game owner's email is verified. Uploads for an unverified owner fail with code `4096`. Check with `get_account` (`email_verified`); if needed, call `request_email_code`, ask the human for the code, and call `verify_email`. A game admin cannot verify for the owner
23
- - chauffeur, from `https://cdn.blazium.online/tools/chauffeur/<platform>/latest/archive/default` where `<platform>` is `windows-amd64`, `linux-amd64`, `linux-arm64`, `darwin-amd64`, or `darwin-arm64`. The zip contains the `chauffeur` binary
23
+ - chauffeur: `npm install -g @blazium-games/cli`. The CDN zip is still valid at `https://cdn.blazium.online/tools/chauffeur/<platform>/latest/archive/default` where `<platform>` is `windows-amd64`, `linux-amd64`, `linux-arm64`, `darwin-amd64`, or `darwin-arm64`. The zip contains the `chauffeur` binary
24
24
 
25
25
  ## 1. Read deploy info
26
26
 
package/skills/blazium-games-player/SKILL.md CHANGED
@@ -52,7 +52,7 @@ The player server acts for one player. It sees the account, wallet, and library,
52
52
  | Redeem a key or gift link | `redeem_key` with the code or link they gave you. `4084` means they already own it and the key is still unused |
53
53
  | Install a game they own or a free game | `why_should_i_trust_this` first. Pass its facts on, and do not call a file safe. Then `install_build` and give them the `blazium://install/<uid>` link. If it fails because the scan isn't clean, don't offer another way to download that file |
54
54
  | Join or leave a beta | `set_channel` (`beta` or `stable`), then `install_build` |
55
- | Play a game | `launch_game`, then give them the `blazium://game/<uid>` link. The desktop app is Windows and Linux. Hand over the link; do not fetch the installer unless they ask |
55
+ | Play a game | `launch_game`, then give them the `blazium://game/<uid>` link. The desktop launcher is Windows and Linux and listens on port 39220. Hand over the link; do not fetch the installer unless they ask. `blazium://buy/<uid>` opens the store page and does not install. Game chat is IRC on `irc.blazium.online` port 6697 |
56
56
  | Download a game they own or a free game | Step 5 (Download) of [purchases](../blazium-games-purchases/SKILL.md) |
57
57
 
58
58
  ## Errors
package/skills/blazium-games-player/references/tools.md CHANGED
@@ -34,7 +34,7 @@ Server: `https://mcp.blazium.games/player`. Scopes: `player:read`, `player:write
34
34
  | `get_shelf` | read | A home page shelf for the human's `os` (`limit` 1-24): `tonight` (short sessions with a healthy build), `unheard_of` (recent listings few people have found), `featured`, `new`, `recently_updated`, `made_with_blazium`, `in_development`, `browser_playable`, `community`, or `tools_and_assets`. `has_browser_build` and `has_downloads` say how each one plays |
35
35
  | `get_game_details` | read | One listing: taxonomy, price, files with scan state and checksum, similar titles, links to its pages on other stores (`store_links`), ownership |
36
36
  | `install_build` | read | License and scan check, checksum, 5-minute download URL, and a `blazium://install/<uid>` hand-off. Uses the channel the human follows unless `channel` is given. Fails unless the file is clean |
37
- | `launch_game` | read | `blazium://game/<uid>` hand-off link for the launcher |
37
+ | `launch_game` | read | `blazium://game/<uid>` hand-off. The launcher remote is port 39220. `blazium://buy/<uid>` does not install. Chat is IRC on `irc.blazium.online:6697` |
38
38
  | `set_channel` | write | Join (`beta`) or leave (`stable`) a game's beta |
39
39
  | `why_should_i_trust_this` | read | Developer, upload provenance, scan history, checksums, and cautions for the current files. Never claims a file is safe |
40
40
  | `recommend` | read | Listings of one `asset_type` (default `game`) for right now from `minutes`, `party_size`, `intent`, `like_uid`, and platform. Deterministic; every result has `reasons` citing listing fields. Pass the reasons on instead of inventing your own |