Agent skill

Add Event Type

by genex-games in genex-games/genex-desktop

Add a new persisted event (custom eventtype in the append-only log) or a transient UI event, with its producer, readers and tests.

MITAuto-check passedTesting & QA

Install Add Event Type

skills CLI
$ npx skills add genex-games/genex-desktop --skill add-event-type -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install genex-games/genex-desktop add-event-type --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/genex-games/genex-desktop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/add-event-type .claude/skills/add-event-type && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
add-event-type
GitHub stars
467
Token cost
~1.3k tokens
SKILL.md length
557 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Add a new persisted event (custom eventtype in the append-only log) or a transient UI event, with its producer, readers and tests.

  • Works in 5 steps: Keep EventData in… → Contract first, in… → Produce it (NewEvent below stands for… → …
  • A run needs to record
  • SKILL.md covers Persisted: a custom event, Transient: a UI event and Tests (red first)
  • Calls npm

What it does

Add Event Type is an agent skill from genex-games/genex-desktop. Add a new persisted event (custom eventtype in the append-only log) or a transient UI event, with its producer, readers and tests. Use when the core, harness or a run needs to record or announce something new.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA. The repository describes itself as: Desktop app for game dev with AI. macOS and Linux, Windows soon. The licence is MIT.

When your agent uses it

  • A run needs to record
  • Announce something new

Example prompts

  • “/add-event-type”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Keep EventData in src/shared/event-log.ts unchanged. New events are
  2. Contract first, in src/shared/custom-events.ts: add a PascalCase key with its exact wire value to CustomEvent
  3. Produce it (NewEvent below stands for the key you add; use the seed
  4. Read it where it shows up: src/shared/studio-activity.ts (STUDIO_RECORD_EVENTS),
  5. Never rewrite or delete old events to migrate; readers accept both shapes.

What it can do on your machine

Read from SKILL.md and the folder at commit b13cc77. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Add Event Type loads about 1.3k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 557 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from genex-games/genex-desktop at commit b13cc77, republished under its MIT licence (© genex-games). 557 words, ~1,271 tokens.

Download SKILL.mdSave it as .claude/skills/add-event-type/SKILL.md (or your agent's skills folder).
name
add-event-type
description
Add a new persisted event (custom event_type in the append-only log) or a transient UI event, with its producer, readers and tests. Use when the core, harness or a run needs to record or announce something new.

Add an event type

Two kinds exist. Pick one before writing code.

KindSurvives restartProducerTransport
Persistedyes; the log is the agent's whole statecore append, harness events.appendstudio:events pull
Transient UInocore emit, harness ctx.notify / ui.notifystudio:event push

If a later session, the chat transcript, Studio activity or a run review must show it, it is persisted. Progress ticks, status lines and "refresh now" hints are transient.

Persisted: a custom event

  1. Keep EventData in src/shared/event-log.ts unchanged. New events are { type: "custom", event_type: "snake_case_name", payload }. Add a new top-level type only for a new substrate primitive (and update normalizeEvent in src/substrate/event-store.ts).
  2. Contract first, in src/shared/custom-events.ts: add a PascalCase key with its exact wire value to CustomEvent (CUSTOM_EVENT_TYPES is derived), and, when the app reads it, its payload to CustomEventMap (a map key the registry lacks fails the typecheck). Every field is optional: old logs and self-edited harness code can emit partial payloads. Reuse a payload type that already lives in src/shared (AssetDeliveredPayload, PluginToolStartedPayload, …).
  3. Produce it (NewEvent below stands for the key you add; use the seed HostMethod from src/harness-seed/loop/host-methods.ts for harness calls):
    • core: await this.append([customEventData(CustomEvent.NewEvent, payload)], threadId) in src/main/studio-core.ts (or the module that owns the behaviour);
    • harness: await ctx.call(HostMethod.EventsAppend, {batch:[...]}) (typed by HarnessHostApi in src/shared/harness-api.ts), as in src/harness-seed/tools/self-tools.ts. Harness-seed is shipped product payload: edit it as product code, and add an incident row (the harness-incident-fix skill).
  4. Read it where it shows up: src/shared/studio-activity.ts (STUDIO_RECORD_EVENTS), src/shared/chat-activity.ts, src/shared/run-review.ts, src/renderer/chat-entries.ts, src/renderer/run-graph.ts, src/renderer/build-progress.ts. Read the payload with customEvent(event, CustomEvent.NewEvent) / customPayload(data, [CustomEvent.NewEvent]) (null for any other event, {} for a missing payload), delegatedPayload for delegated.<engine>, or customRecord for any custom event; no data.payload as. Grep event_type === to find every consumer of a similar event, and keep the names consistent with them.
  5. Never rewrite or delete old events to migrate; readers accept both shapes.
Show full SKILL.md (252 more words)Show less

Transient: a UI event

  • Contract first: add the exact wire name and payload to UiEventMap, and a PascalCase key to UiEvent in src/shared/ui-events.ts; UI_EVENT_TYPES is derived (named like run.finished or preview.frame). Fields the harness writes stay optional: it is edited at runtime and main forwards its notifications unchanged.
  • Core: this.emit(UiEvent.NewEvent, payload), typed by the map; main's pushUiEvent in src/main/index.ts (also typed) forwards it as studio:event (a push channel of src/shared/ipc-channels.ts).
  • Harness: keep the matching wire name in a seed-owned as const vocabulary beside its producer, then call ctx.notify(SeedUiEvent.NewEvent, payload). The example name stands for that vocabulary; there is no shared seed UiEvent export. Never import app source into the editable seed. Keep the seed/app contract covered by its contract tests.
  • Renderer: window.studio.onEvent(event => { if (event.type === UiEvent.NewEvent) … }) narrows the payload; isUiEventIn(event, "area.") narrows a family. No event.payload as.
  • tests/conformance/ui-events.test.ts fails when a produced name is missing from the map, or a key is no longer produced.
  • Nothing may depend on a transient event having been seen; the next pull must be able to rebuild the state.

Tests (red first)

  • tests/conformance/custom-events.test.ts scans src as data and fails when the code writes or reads a custom event name missing from CUSTOM_EVENT_TYPES, or the registry keeps a name nothing uses.

  • Reader: feed synthetic EventEnvelopes (including an old/partial payload) to the pure reader, as tests/conformance/studio-activity.test.ts and chat-history.test.ts do.

  • Producer: drive the behaviour through tests/helpers/core-lite.ts and read the log back with core.store.listEvents(threadId); for harness producers use startRig and customEvents from tests/helpers/studio-rig.ts.

  • Log invariants: tests/conformance/event-store.test.ts when touching the store itself.

sh
npm test -- tests/conformance/studio-activity.test.ts tests/conformance/<producer>.test.ts

© genex-games, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/add-event-type of genex-games/genex-desktop.

Open the folder on GitHubat commit b13cc77

Compare with similar skills

Add Event Type next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Add Event Type compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Event Type this skillgenex-games/genex-desktop467—~1.3kAutomated safety check: PassMIT
Web Application Testinganthropics/skills180k51 repos~966Automated safety check: PassApache-2.0
Diagnosing Bugsfossasia/eventyay-interpretation1.6k32 repos~2.1kAutomated safety check: PassApache-2.0
TDDpietheinstrengholt/rssmonster56430 repos~906Automated safety check: PassMIT
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph11211 repos~2.4kAutomated safety check: PassNone
TDDsanity-io/sanity6.4k20 repos~1kAutomated safety check: PassMIT

Similar skills

  • Web Application Testing

    anthropics/skills

    Official

    Tests local web applications with Python Playwright scripts, checking frontend behavior, capturing screenshots and reading browser console logs.

    180k GitHub starsUsed in 51 repos~966 tokens
    Testing & QAAuto-check passed
  • Diagnosing Bugs

    fossasia/eventyay-interpretation

    Diagnosis loop for hard bugs and performance regressions. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 32 repos~2.1k tokens
    Testing & QAAuto-check passed
  • TDD

    pietheinstrengholt/rssmonster

    Test-driven development. An agent skill from pietheinstrengholt/rssmonster.

    564 GitHub starsUsed in 30 repos~906 tokens
    Testing & QAAuto-check passed
  • TDD Workflow

    hellangleZ/burn-in-cceverywhere-ralph

    A skill your agent uses when writing new features, fixing bugs, or refactoring code.

    112 GitHub starsUsed in 11 repos~2.4k tokens
    Testing & QAAuto-check passed
  • TDD

    sanity-io/sanity

    Official

    Test-driven development with red-green-refactor loop. An agent skill from sanity-io/sanity.

    6.4k GitHub starsUsed in 20 repos~1k tokens
    Testing & QAAuto-check passed
  • Context Driven Development

    Ibrahim-3d/orchestrator-supaconductor

    A skill your agent uses when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md…

    381 GitHub starsUsed in 9 repos~2.9k tokens
    Testing & QAAuto-check passed

More from genex-games/genex-desktop

  • Add Ipc Channel

    genex-games/genex-desktop

    Add or change a renderer-to-main IPC channel (a new window.studio call) end to end - main handler, preload, typed API, fixture classification and tests.

    467 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Add Plugin Tool

    genex-games/genex-desktop

    Add or change an agent-callable tool contributed by a Studio plugin (manifest declaration, backend handler, consent, docs and tests).

    467 GitHub stars~841 tokensUpdated today
    Auto-check passed
  • Harness Incident Fix

    genex-games/genex-desktop

    Fix a bug in the in-app harness loop (src/harness-seed/) test-first - write the incident row that reproduces it, see it fail, fix, then run the harness gate.

    467 GitHub stars~843 tokensUpdated today
    Auto-check passed
  • Run Area Tests

    genex-games/genex-desktop

    Pick and run only the tests a change can affect - the affected-tests selector, one knowledge-map area, or named files - instead of the full suite.

    467 GitHub stars~698 tokensUpdated today
    Auto-check passed
  • Break

    genex-games/genex-desktop

    Renders a component you choose in every state and scenario on a temporary page and stress tests it.

    467 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Verify UI Via Dev Control

    genex-games/genex-desktop

    Verify renderer, IPC, preview or startup changes through owned studio:dev profiles, or hand off the real app for manual testing.

    467 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

Categories

Questions about Add Event Type

What does Add Event Type do?

Add a new persisted event (custom eventtype in the append-only log) or a transient UI event, with its producer, readers and tests. Add Event Type is an agent skill from genex-games/genex-desktop. Add a new persisted event (custom eventtype in the append-only log) or a transient UI event, with its producer, readers and tests.

When should I use Add Event Type?

Add Event Type fits situations like: A run needs to record; announce something new.

How do I install Add Event Type in Claude Code?

Run `npx skills add genex-games/genex-desktop --skill add-event-type -a claude-code`. Or copy the skill folder (.agents/skills/add-event-type in genex-games/genex-desktop) into .claude/skills/add-event-type in your project. Claude Code loads it when a task matches its description.

How do I install Add Event Type in Codex?

Run `npx skills add genex-games/genex-desktop --skill add-event-type -a codex`. Or copy the skill folder (.agents/skills/add-event-type in genex-games/genex-desktop) into .agents/skills/add-event-type in your project. Codex loads it when a task matches its description.

Can I use Add Event Type in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add genex-games/genex-desktop --skill add-event-type -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-event-type, .gemini/skills/add-event-type, .github/skills/add-event-type and .opencode/skills/add-event-type in your project.

What does Add Event Type need to run?

Going by SKILL.md and its folder, Add Event Type needs the command-line tools its instructions call (npm).

Does Add Event Type access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Add Event Type safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Add Event Type use?

Add Event Type is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add Event Type use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Add Event Type?

Skills that share tags, products or a category with Add Event Type: Web Application Testing (anthropics/skills, 180k stars), Diagnosing Bugs (fossasia/eventyay-interpretation, 1.6k stars), TDD (pietheinstrengholt/rssmonster, 564 stars) and TDD Workflow (hellangleZ/burn-in-cceverywhere-ralph, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Event Type?

genex-games (a GitHub organization) maintains it in genex-games/genex-desktop, which has 467 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

Source: genex-games/genex-desktop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.