name	skyhelper
description	Work in the SkyHelper TypeScript monorepo for Sky: Children of the Light Discord bot tasks. Use when editing, reviewing, debugging, or explaining code from the repository root, especially bot commands, handlers, planner displays, localization JSON, constants data, jobs, shared utils, build/test/lint workflows, or Discord API component interactions.

SkyHelper

Use this skill for repo-specific SkyHelper work. Start by reading the relevant files in the workspace, then follow the existing TypeScript, Discord Core, i18n, and component-builder patterns.

Workflow

Work from the repository root, identified by package.json, pnpm-lock.yaml, and turbo.json.
Read references/repo-guide.md when you need repo layout, validation commands, command conventions, localization paths, planner patterns, or common gotchas.
Prefer rg/rg --files for navigation. Inspect neighboring handlers before adding new patterns.
Keep edits scoped to the requested package and preserve unrelated user changes.
Validate with the narrowest useful command first, then broader checks when the change affects shared behavior.

Default Commands

Install: pnpm install --frozen-lockfile
Build all: pnpm build
Test all: pnpm test
Lint all except website: pnpm lint
Bot dev: pnpm bot:dev
Bot command registration in dev: pnpm --filter skyhelper commands:dev
Bot format: pnpm --filter skyhelper run format

Set long enough timeouts: install can take about 45 seconds, tests about 30 seconds, and build about 15 seconds.

Coding Rules

Use pnpm workspace filters instead of npm or direct package-manager swaps.
Use existing path aliases such as @/ inside packages/skyhelper/src.
Use discord-api-types / @discordjs/core types and the repo's component builders from @skyhelperbot/utils.
Add or update locale keys in packages/constants/locales/<lang>/...; keep en-US as the source shape.
For Discord custom IDs, prefer the existing store serialization helpers where state or user isolation matters.
For command metadata, update the matching file under packages/skyhelper/src/bot/modules/commands-data/ and the command implementation under packages/skyhelper/src/bot/modules/inputCommands/.

Validation

For code-only bot changes, usually run:

pnpm --filter skyhelper build
pnpm --filter skyhelper test

For constants, utils, or cross-package changes, run:

pnpm build
pnpm test

For locale edits, also consider:

pnpm check-locales

SkyHelper

Use this skill for repo-specific SkyHelper work. Start by reading the relevant files in the workspace, then follow the existing TypeScript, Discord Core, i18n, and component-builder patterns.

Workflow

Work from the repository root, identified by package.json, pnpm-lock.yaml, and turbo.json.

Read references/repo-guide.md when you need repo layout, validation commands, command conventions, localization paths, planner patterns, or common gotchas.

Prefer rg/rg --files for navigation. Inspect neighboring handlers before adding new patterns.

Keep edits scoped to the requested package and preserve unrelated user changes.

Validate with the narrowest useful command first, then broader checks when the change affects shared behavior.

Default Commands

Install: pnpm install --frozen-lockfile

Build all: pnpm build

Test all: pnpm test

Lint all except website: pnpm lint

Bot dev: pnpm bot:dev

Bot command registration in dev: pnpm --filter skyhelper commands:dev

Bot format: pnpm --filter skyhelper run format

Set long enough timeouts: install can take about 45 seconds, tests about 30 seconds, and build about 15 seconds.

Coding Rules

Use pnpm workspace filters instead of npm or direct package-manager swaps.

Use existing path aliases such as @/ inside packages/skyhelper/src.

Use discord-api-types / @discordjs/core types and the repo's component builders from @skyhelperbot/utils.

Add or update locale keys in packages/constants/locales/<lang>/...; keep en-US as the source shape.

For Discord custom IDs, prefer the existing store serialization helpers where state or user isolation matters.

For command metadata, update the matching file under packages/skyhelper/src/bot/modules/commands-data/ and the command implementation under packages/skyhelper/src/bot/modules/inputCommands/.

Validation

For code-only bot changes, usually run:

pnpm --filter skyhelper build pnpm --filter skyhelper test

For constants, utils, or cross-package changes, run:

pnpm build pnpm test

For locale edits, also consider:

pnpm check-locales