SpineEventEngine.github.io

Validate the Hugo documentation site under `docs/` or `site/` for broken links. Builds the site, starts the Hugo server locally, runs Lychee against the rendered HTML using the repo's `lychee.toml`, and reports any broken URLs grouped by source Markdown page. Use locally before pushing changes that touch `docs/**` or `site/**`, when CI's `Check Links` job fails, or whenever the user asks to "check doc links". Read-only with respect to the project sources. Does **not** cover Javadoc/KDoc (out of scope for this skill).

Run the pre-PR checklist for this repo: apply the version gate only when the repository has a root `version.gradle.kts`, run a scope-dependent build/check command per `.agents/running-builds.md` (docs-only → `dokka`; code/deps → `build`; proto → `clean build`; no documented command → skipped), and invoke the relevant reviewers (`kotlin-review`, `review-docs`, `dependency-audit`, `check-links`) against the branch diff. On success, write a sentinel file at `.git/pre-pr.ok` so the `gh pr create` hook can verify the checklist ran for the current HEAD. Use before opening a PR, or when CI rejected a branch and you want a fast local repro.

Resolve the on-disk location of a Maven artifact's source code, so you can `Grep`/`Read` it directly instead of running `unzip` against JARs in the Gradle cache. Use this whenever you need to inspect a library's API or implementation — definitions of public types, method signatures, KDoc, internal helpers, etc.

Update the Gradle wrapper version used by this repository. Use when asked to upgrade Gradle, bump the Gradle wrapper, move the project to the latest Gradle release from the official release notes, run the Gradle build, and commit Gradle wrapper and dependency report changes separately.

Bump the project version in `version.gradle.kts` following the Spine SDK versioning policy. Use when starting a new branch, before opening a PR, or when CI rejects a branch for a missing/insufficient version increment. Covers locating the published version value, choosing the increment, committing the bump, rebuilding reports, and resolving version conflicts.

Audit changes to dependency declarations under `buildSrc/src/main/kotlin/io/spine/dependency/` — catches accidental version downgrades, BOM mismatches, missing deprecation markers when artifacts are renamed or removed, copyright drift, and convention drift. Use whenever a diff touches that directory, or when asked to "audit this dependency bump". Read-only; does not run builds.

Walk every dependency declaration under `buildSrc/src/main/kotlin/io/spine/dependency/`, discover the latest accepted version of each artifact from the URL hinted in its file (or from Maven metadata if no URL is present), and update the `version` constant in place. External dependency scopes accept only released versions; the `local` scope also accepts snapshots and pre-releases published from sibling Spine repos. Use when asked to refresh dependency versions, bump libraries, run a dependency audit, or "see what's stale".

Convert Java code to Kotlin, including Java API comments from Javadoc to KDoc. Use when asked to migrate Java files, classes, methods, nullability semantics, or common Java patterns into idiomatic Kotlin while preserving behavior.

Review Kotlin (and Java) changes in this repo against the Spine coding guidelines, safety rules, and testing policy. Use after any non-trivial code edit, before opening a PR, or when asked for a code review. Read-only; does not run builds.

Move or rename any files/directories in a repo: preserve history, update all references and build metadata, verify no stale paths remain.

Review documentation changes — KDoc/Javadoc inside Kotlin/Java sources and Markdown docs (`README.md`, `docs/**`) — against Spine documentation conventions. Use when a diff touches doc comments or Markdown, before opening a doc-affecting PR, or when asked for a documentation review. Read-only; does not run builds.

Update source file copyright headers from the IntelliJ IDEA copyright profile, replacing `today.year` with the current year. Automatically apply when source files are modified in a change set.

Verify the current branch has bumped `version.gradle.kts` strictly above the base ref; invoke `/bump-version` to auto-recover if not. Composable: other modifying skills (`dependency-update`, `bump-gradle`, `java-to-kotlin`, `move-files`) call this as their final step so a `./gradlew build` or `publishToMavenLocal` can never overwrite a previously published Maven Local artifact that integration tests in consumer repos depend on.

Write, edit, and restructure user-facing and developer-facing documentation. Use when asked to create/update docs such as `README.md`, `docs/**`, and other Markdown documentation, including keeping docs navigation data in sync; when drafting tutorials, guides, troubleshooting pages, or migration notes; and when improving inline API documentation (KDoc) and examples.