Skill for Cursor

Use this as a compact operating guide when developing in Cursor on this repository.

Download AI skills

One-file prompts for Cursor or Claude. In a clone they are at website/static/skills/. Use the docs Search box in the navbar (⌘K / Ctrl+K) to find SDK topics quickly.

PL: Wyszukiwarka — pole Search w prawym górnym rogu (`⌘K` / `Ctrl+K`). Pobranie skilli — przyciski poniżej lub menu AI Skills → ↓ Download Cursor (.md) / ↓ Download Claude (.md).

Cursorcursor-skill.mdDownloadClaudeclaude-skill.mdDownload

Direct links (copy)

• On this site: https://koderhack.github.io/veltokit/skills/cursor-skill.md
• On this site: https://koderhack.github.io/veltokit/skills/claude-skill.md
• GitHub raw: https://raw.githubusercontent.com/koderhack/veltokit/main/website/static/skills/cursor-skill.md
• GitHub raw: https://raw.githubusercontent.com/koderhack/veltokit/main/website/static/skills/claude-skill.md

Best for understanding the repo: open AGENTS.md at the repo root (already in clone). Cursor: skill is at .cursor/skills/veltokit/SKILL.md or paste downloaded file into chat. Claude: attach AGENTS.md or add Project instructions from the downloaded file.

What to open first

1. VeltoKit/MotionSDK.swift
2. VeltoKit/GameInput.swift
3. app/Platform/TrikiInputAdapter.swift
4. app/UI/TrikiUI/TrikiUIComponents.swift
5. Relevant page in SDK docs

Default implementation loop

1. Confirm scope (SDK core vs app integration vs docs website).
2. Read current implementation before proposing changes.
3. Apply minimal edits with stable API names.
4. Update /// docs for touched Swift public/internal APIs.
5. Sync website docs for behavior changes.
6. Run lint/tests for changed area.

Cursor-first prompt templates

1) Implement minimal fix

Implement a minimal, behavior-preserving fix in the touched files.
Do not rename symbols unless required.
Explain root cause and verify with focused checks.

2) Document API changes

Add or update Swift /// comments for all touched public/internal APIs.
Include purpose, parameters, return value, side effects, and short example where helpful.
Do not change runtime logic.

3) Triki UI debug pass

Trace trikiUIScreen lifecycle from activation to focus and onActivate callback.
Check MotionInputProvider liveInput -> focused slot mapping -> hold/button confirmation.
Propose smallest safe patch.

Guardrails

• Keep gameplay behavior deterministic.
• Prefer additive changes over rewrites.
• Keep docs actionable and example-driven.
• If uncertain, infer from usage and existing architecture.

For Cursor Claude hub · Skill for Claude