@blazium-games/skills 0.1.0 → 0.1.1

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 (5) hide show
  1. package/GROK.md +32 -0
  2. package/README.md +25 -1
  3. package/SKILL_TREE.md +60 -0
  4. package/package.json +3 -1
  5. package/skills/blazium-games-analytics/SKILL.md +2 -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
@@ -4,7 +4,31 @@ Agent skills for [Blazium Games](https://blazium.games), the store operated by D
4
4
 
5
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.
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 chauffeur | [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 | [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.1",
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