@blazium-games/skills 0.1.1 → 0.1.3

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 (6) hide show
  1. package/README.md +25 -26
  2. package/SKILL_TREE.md +2 -2
  3. package/package.json +2 -2
  4. package/skills/blazium-games-deploy/SKILL.md +1 -1
  5. package/skills/blazium-games-player/SKILL.md +1 -1
  6. package/skills/blazium-games-player/references/tools.md +2 -2
package/README.md CHANGED
@@ -1,20 +1,29 @@
1
1
  # Blazium Games skills
2
2
 
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.
3
+ Agent skills for [Blazium Games](https://blazium.games), the store operated by Divine Games, Inc. They are not the engine skills at [`@blazium-engine/skills`](https://www.npmjs.com/package/@blazium-engine/skills), and they do not install Hub or the engine.
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
+ ## Install
6
+
7
+ ```bash
8
+ npm install @blazium-games/skills
9
+ ```
10
+
11
+ Cursor: add `blazium-games/games_skill` from **Cursor Settings > Plugins**, then enable **Blazium Games**.
6
12
 
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).
13
+ ## Platform
8
14
 
9
- ## Documentation
15
+ - Docs: [docs.blazium.games](https://docs.blazium.games) and the map [llms.txt](https://docs.blazium.games/llms.txt)
16
+ - Skills: `npm install @blazium-games/skills`, or Cursor Settings > Plugins > `blazium-games/games_skill`. Index: [SKILL_TREE.md](https://github.com/blazium-games/games_skill/blob/master/SKILL_TREE.md)
17
+ - MCP: [developer server](https://docs.blazium.games/docs/mcp) at `https://mcp.blazium.games/mcp`, and [player server](https://docs.blazium.games/docs/mcp/player) at `https://mcp.blazium.games/player`
18
+ - CLI: `npm install -g @blazium-games/cli` (`chauffeur`), guide at [docs.blazium.games/docs/cli](https://docs.blazium.games/docs/cli)
19
+ - Launcher: Windows setup from [Releases](https://github.com/blazium-games/games_launcher/releases), guide at [desktop app](https://docs.blazium.games/docs/storefront/desktop-app)
20
+ - Support: [blazium-games/support](https://github.com/blazium-games/support/issues). Status: [status.blazium.games](https://status.blazium.games)
10
21
 
11
- Read these before guessing how the platform works:
22
+ ## This repo
12
23
 
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)
24
+ This package is the versioned release. The guide and the in-repo plugin source stay in [games_docs](https://github.com/blazium-games/games_docs). The skill index, with links into the guide, is [SKILL_TREE.md](SKILL_TREE.md). The catalog is [https://cdn.blazium.app/games-skills/skills.json](https://cdn.blazium.app/games-skills/skills.json).
25
+
26
+ 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).
18
27
 
19
28
  | Skill | Guide |
20
29
  |-------|--------|
@@ -28,20 +37,6 @@ Read these before guessing how the platform works:
28
37
  | `blazium-games-player` | [Player MCP](https://docs.blazium.games/docs/mcp/player) |
29
38
  | `blazium-games-purchases` | [Agent purchases](https://docs.blazium.games/docs/payments/agent-purchases) |
30
39
 
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).
32
-
33
- ## Install
34
-
35
- ```bash
36
- npm install @blazium-games/skills
37
- ```
38
-
39
- Cursor: add `blazium-games/games_skill` from **Cursor Settings > Plugins**.
40
-
41
- The catalog is [https://cdn.blazium.app/games-skills/skills.json](https://cdn.blazium.app/games-skills/skills.json).
42
-
43
- ## Plugins
44
-
45
40
  | Plugin | What it covers |
46
41
  |--------|----------------|
47
42
  | `blazium-games-developer` | Get started, store page, deploy, crash reporting, debug crash, analytics, keys |
@@ -50,9 +45,13 @@ The catalog is [https://cdn.blazium.app/games-skills/skills.json](https://cdn.bl
50
45
 
51
46
  `mcp.json` points at `https://mcp.blazium.games/mcp` and `https://mcp.blazium.games/player`. A token belongs to one server.
52
47
 
53
- ## Hosts
54
-
55
48
  - Claude Code reads `.claude-plugin/marketplace.json`.
56
49
  - Cursor reads `.cursor-plugin/marketplace.json`.
57
50
  - Codex reads `.agents/plugins/marketplace.json`.
58
51
  - Grok reads the Claude marketplace and `./.grok/skills/`. See [GROK.md](GROK.md).
52
+
53
+ Platform bugs go to [blazium-games/support](https://github.com/blazium-games/support/issues), not this repository's issue tracker.
54
+
55
+ ## License
56
+
57
+ Licensed under the MIT License — see [LICENSE](LICENSE).
package/SKILL_TREE.md CHANGED
@@ -23,12 +23,12 @@ New to Blazium Games? Start with [blazium-games-get-started](skills/blazium-game
23
23
  |-------|-----------|------|
24
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
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 chauffeur | [Deploy builds](https://docs.blazium.games/docs/deploy), [CLI](https://docs.blazium.games/docs/cli), [CI](https://docs.blazium.games/docs/cli/ci) |
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
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
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
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
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 | [Player MCP](https://docs.blazium.games/docs/mcp/player) |
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
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
33
 
34
34
  ## Typical paths
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@blazium-games/skills",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "description": "Agent skills for the Blazium Games platform.",
5
5
  "repository": "https://github.com/blazium-games/games_skill",
6
6
  "license": "MIT",
@@ -15,7 +15,7 @@
15
15
  "access": "public"
16
16
  },
17
17
  "homepage": "https://blazium.games",
18
- "bugs": "https://github.com/blazium-games/games_skill/issues",
18
+ "bugs": "https://github.com/blazium-games/support/issues",
19
19
  "author": "Blazium Games",
20
20
  "keywords": [
21
21
  "blazium",
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 you can download today is Windows 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 |
@@ -61,7 +61,7 @@ Server: `https://mcp.blazium.games/player`. Scopes: `player:read`, `player:write
61
61
  | `ui://blazium-games/wallet.html` | Balance, ledger, spending limit, and a card top-up link |
62
62
  | `ui://blazium-games/approval.html` | Approval status, confirm link, and the emailed code |
63
63
  | `ui://blazium-games/library.html` | Owned games, redeem, and download links |
64
- | `ui://blazium-games/handoff.html` | `blazium://` hand-off for the Windows and Linux launcher |
64
+ | `ui://blazium-games/handoff.html` | `blazium://` hand-off for the Windows launcher |
65
65
  | `ui://blazium-games/account.html` | Verification, timezone, and links to finish sign-in on the website |
66
66
  | `ui://blazium-games/feedback.html` | Reviews, bug reports, taste, and tag suggestions. Send only what the human wrote |
67
67
  | `ui://blazium-games/friends.html` | Friends and requests. Send and answer only from a click |