Cut v0.3.0: stamp CHANGELOG, bump version refs

Move the [Unreleased] block to v0.3.0 dated 2026-05-07, with a focused
"Breaking changes" section calling out the --from-template directory
requirement (#84). Cross-link the four PRs that landed since v0.2.1
(#81, #84, #86, #87) and add a Changed entry covering the docs-site
refresh that ships in this branch.

Bump the corresponding version refs in AGENTS.md (current release +
milestone snapshot now covers M0–M7), INSTALL.md (SKERN_VERSION pin
example), docs/guide/installation.md (matching pin example), and
docs/guide/index.md (current-release callout).

Docs build verified.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: devrimcavusoglu

AGENTS.md

@@ -4,7 +4,7 @@
 
 Skern is a minimal, agent-first CLI tool for managing Agent Skills across agentic development platforms (Claude Code, Codex CLI, OpenCode, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Continue, and more). It follows the Agent Skills open standard (agentskills.io) and uses `SKILL.md` files with YAML frontmatter as the canonical format.
 
-The project is written in **Go 1.25+** and the current release is **v0.2.0**.
+The project is written in **Go 1.25+** and the current release is **v0.3.0**.
 
 ## Repository Layout
 
@@ -267,7 +267,10 @@ The full list is generated from `internal/platform/spec.go` — append a row the
 
 ## Current Status
 
-Milestones M0–M6 are complete (v0.2.0). M6 shipped dynamic skill loading per #52 — batch install/uninstall, capacity reporting in install/uninstall output, `--enforce-budget` opt-in, `--with-platforms` flag on `skill list`, removal of `--platform all`. The v0.1.x → v0.2.0 transition introduced a **breaking change** to the JSON shape of install/uninstall results (`skills[]` + top-level `platform`/`capacity` instead of `platforms[]`).
+Milestones M0–M7 are complete (v0.3.0).
+
+- **M6** (v0.2.0) — dynamic skill loading per #52: batch install/uninstall, capacity reporting in install/uninstall output, `--enforce-budget` opt-in, `--with-platforms` flag on `skill list`, removal of `--platform all`. The v0.1.x → v0.2.0 transition introduced a breaking change to the JSON shape of install/uninstall results (`skills[]` + top-level `platform`/`capacity` instead of `platforms[]`).
+- **M7** (v0.3.0) — declarative platform registry: per-platform Go files collapsed into a single `Spec` table (`internal/platform/spec.go`) plus a generic `Adapter`. Five new adapters (`cursor`, `gemini-cli`, `github-copilot`, `windsurf`, `continue`) shipped alongside the rewrite. Also in v0.3.0: `skern init --instructions` writes the skern usage snippet into agent instruction files, `--from-template` requires a skill directory (small breaking change), and Windows joins the CI matrix.
 
 ### Future Roadmap
 

CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [v0.3.0] — 2026-05-07
+
+Platform registry rewrite, five new adapters, agent-instruction snippet
+writer, and a focused breaking change to `--from-template`.
+
+### Breaking changes
+
+- **`skill create --from-template <path>` now requires a skill directory.**
+  A skill is a folder, so `--from-template` accepts only a directory containing
+  a `SKILL.md`. Passing a bare file (a `SKILL.md` or a body-only markdown file)
+  is rejected with a clear error pointing at the parent directory. The
+  previous behavior of treating a non-frontmatter markdown file as a raw body
+  is removed — wrap such bodies in a directory with a `SKILL.md` instead. ([#84])
+
 ### Added
 
 - **`skern init` can now write a skern usage snippet into agent instruction
@@ -19,19 +33,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   `--target <path>` overrides auto-discovery for explicit files, and
   `--print-instructions` emits the snippet to stdout without writing files.
   The `InitResult` JSON envelope grows an `instructions` field reporting
-  what was written.
+  what was written. ([#87])
 - **Five new platform adapters: `cursor`, `gemini-cli`, `github-copilot`,
   `windsurf`, `continue`.** All five accept the same `--platform` flag, route
   installs to the platform's expected skill directory, and participate in
   `skern platform list`/`status` matrices. Path conventions follow
   [vercel-labs/skills](https://github.com/vercel-labs/skills#supported-agents).
-  ([#80])
+  ([#81])
 - **Declarative platform registry.** Adapters are now defined as one row in
   `internal/platform/spec.go` — a `Spec` carrying name, user dir, project dir,
   and home-relative detection paths. A single generic `Adapter` struct
   implements the `Platform` interface from any spec row, replacing the
   per-platform Go files (`claude.go`, `codex.go`, `opencode.go`). Adding a
-  platform is a one-line PR. ([#80])
+  platform is a one-line PR. ([#81])
+- **Windows added to the CI matrix** — every PR now runs the test suite on
+  Windows in addition to macOS and Linux. ([#86])
+- **`--from-template` preserves template frontmatter and copies sibling
+  assets.** The template's `description`, `tags`, `metadata.author`, and
+  `metadata.version` are preserved on the new skill (#82) and every sibling
+  file or subdirectory (`references/`, `templates/`, `VENDORED.md`, …) is
+  copied alongside the new `SKILL.md` (#83). The CLI `<name>` argument always
+  wins over the template's name; other flags override template values when
+  explicitly set, otherwise template values are preserved.
 
 ### Changed
 
@@ -43,20 +66,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **CLI flag help and error messages enumerate the registered platforms
   dynamically** — adding a platform updates `--platform` help and the
   "unknown platform" error text without touching the CLI.
-- **`skill create --from-template <path>` now requires a skill directory.**
-  A skill is a folder, so `--from-template` accepts only a directory containing
-  a `SKILL.md`. Passing a bare file (a `SKILL.md` or a body-only markdown file)
-  is rejected with a clear error that points at the parent directory. The
-  template's frontmatter (`description`, `tags`, `metadata.author`,
-  `metadata.version`) is preserved on the new skill (#82) and every sibling
-  file or subdirectory (e.g., `references/`, `templates/`, `VENDORED.md`) is
-  copied alongside the new `SKILL.md` (#83). The CLI `<name>` argument always
-  wins over the template's `name`; other flags override template values when
-  explicitly set, otherwise template values are preserved. **Breaking:** the
-  previous behavior of treating a non-frontmatter markdown file as a raw body
-  is removed — wrap such bodies in a directory with a `SKILL.md` instead.
-
-[#80]: https://github.com/devrimcavusoglu/skern/issues/80
+- **Documentation site comprehensively refreshed** — eight platform pages,
+  reference covers `skill import` / `skill version` / `skill diff`, validation
+  page split into errors/warnings/hints, installation page covers all three
+  OSes, agent-setup leads with `init --instructions`.
+
+[v0.3.0]: https://github.com/devrimcavusoglu/skern/compare/v0.2.1...v0.3.0
+[#81]: https://github.com/devrimcavusoglu/skern/pull/81
+[#84]: https://github.com/devrimcavusoglu/skern/pull/84
+[#86]: https://github.com/devrimcavusoglu/skern/pull/86
+[#87]: https://github.com/devrimcavusoglu/skern/pull/87
 
 ## [v0.2.1] — 2026-05-03
 

INSTALL.md

@@ -46,11 +46,11 @@ Override with the `SKERN_INSTALL_DIR` environment variable.
 ## Pin a specific version
 
 ```sh
-SKERN_VERSION=v0.2.1 curl -fsSL https://raw.githubusercontent.com/devrimcavusoglu/skern/main/scripts/install.sh | bash
+SKERN_VERSION=v0.3.0 curl -fsSL https://raw.githubusercontent.com/devrimcavusoglu/skern/main/scripts/install.sh | bash
 ```
 
 ```powershell
-$env:SKERN_VERSION = 'v0.2.1'; irm https://raw.githubusercontent.com/devrimcavusoglu/skern/main/scripts/install.ps1 | iex
+$env:SKERN_VERSION = 'v0.3.0'; irm https://raw.githubusercontent.com/devrimcavusoglu/skern/main/scripts/install.ps1 | iex
 ```
 
 ## Build from source

docs/guide/index.md

@@ -33,7 +33,7 @@ Skills should not live inside models. They should live in code. Versioned. Compo
 
 ## What's Shipped
 
-The current release is **v0.2.1**. Major capabilities already in place:
+The current release is **v0.3.0**. Major capabilities already in place:
 
 - Eight platform adapters (Claude Code, Codex CLI, OpenCode, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Continue)
 - Cross-platform binaries for macOS, Linux, and Windows

docs/guide/installation.md

@@ -29,11 +29,11 @@ powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.c
 Set `SKERN_VERSION` before running the installer:
 
 ```sh
-SKERN_VERSION=v0.2.1 curl -fsSL https://raw.githubusercontent.com/devrimcavusoglu/skern/main/scripts/install.sh | bash
+SKERN_VERSION=v0.3.0 curl -fsSL https://raw.githubusercontent.com/devrimcavusoglu/skern/main/scripts/install.sh | bash
 ```
 
 ```powershell
-$env:SKERN_VERSION = 'v0.2.1'; irm https://raw.githubusercontent.com/devrimcavusoglu/skern/main/scripts/install.ps1 | iex
+$env:SKERN_VERSION = 'v0.3.0'; irm https://raw.githubusercontent.com/devrimcavusoglu/skern/main/scripts/install.ps1 | iex
 ```
 
 ## Custom Install Directory