v1.4.0 — plugin first-run notice for opt-in extras

Added

• Plugin first-run notice (hooks/hooks.json + scripts/plugin-notice.sh) — a one-time SessionStart notice for plugin installs that tells users about the opt-in extras a sandboxed plugin can't auto-configure (always-on routing reminder, status line, pre-commit gates, AGENTS.md) and links to the setup docs. Shows once (marker-guarded); clone users get the same from install.sh.
• README "Optional extras (for plugin users)" — how plugin users turn on the routing hook, status line, and generators (which ship with the plugin) to match the clone experience.

Full changelog: https://github.com/martinholovsky/SOTA-skills/blob/main/CHANGELOG.md

v1.3.0 — skills-used status line + dotfiles-aware routing setup

Added

• scripts/statusline.sh — a Claude Code status line that shows which skills you've actually used this session (parsed from the transcript's Skill invocations), plus model / context % / dir / branch. Falls back to the count of installed skills before any are used. Requires jq.

Changed

• scripts/install.sh now offers always-on routing setup after linking — a global CLAUDE.md directive + a UserPromptSubmit hook so the skills apply without trigger words. Interactive and dotfiles-aware: detects existing/symlinked ~/.claude/CLAUDE.md and settings.json, asks before changing anything (recommended pre-filled), backs up, writes through symlinks so dotfiles stay authoritative, and is idempotent via managed markers. Flags: --routing, --no-routing, --yes.

Full changelog: https://github.com/martinholovsky/SOTA-skills/blob/main/CHANGELOG.md

v1.2.0 — spec-driven dev, BDD, universal AGENTS.md, docs-gate

Added

• Spec-driven development rule — sota-docs-workflow/rules/05: the intent→plan→tasks→implement→verify loop, testable acceptance criteria, [NEEDS CLARIFICATION] markers, spec-drift control, steering vs per-feature specs.
• BDD / specification by example rule — sota-testing/rules/08: declarative Given-When-Then, the outside-in double loop with TDD, anti-patterns, tracing scenarios to spec acceptance criteria.
• scripts/gen-agents-md.sh — generate an AGENTS.md so non-Claude agents (Codex, Cursor, Copilot, Gemini CLI, Windsurf, Zed, …) route through the skills. Thin pointer built from frontmatter; reads rules on demand; idempotent.
• scripts/init-gates.sh --docs-gate — opt-in pre-commit hook that blocks a commit changing code without updating docs (bypassable).

Changed

• The always-on directive (generated AGENTS.md + README example) now leads with two standing rules for every answer: validate every claim against a primary source before asserting, and keep docs current in the same change.
• Dropped the README "last refresh" date line (duplicated git history).

Full changelog: https://github.com/martinholovsky/SOTA-skills/blob/main/CHANGELOG.md

v1.1.0 — plugin install, language-detecting gates, always-on routing

SOTA-skills is now installable and updatable as a Claude Code plugin, with new tooling to keep the skills applied and your repos gated.

Install

/plugin marketplace add martinholovsky/SOTA-skills
/plugin install sota-skills@sota-skills

Update later with /plugin update sota-skills@sota-skills. (Clone users: ./scripts/install.sh --update.)

Added

• Claude Code plugin + marketplace (.claude-plugin/) — native install/update for users who don't clone + symlink. One repo is both plugin and marketplace; the top-level skills/ auto-discovers.
• scripts/install.sh — installer that doubles as the updater: re-run after git pull to link newly-added skills and prune removed ones (idempotent). Flags: --update, --project DIR, --copy.
• scripts/init-gates.sh — detects a repo's languages and generates a SOTA-aligned .pre-commit-config.yaml: ruff/mypy/pytest/pip-audit, gofumpt/golangci-lint/govulncheck, clippy/cargo-audit, eslint/tsc/audit, shellcheck/shfmt, plus gitleaks. Fast checks on commit, heavy on push; idempotent via a managed marker block.
• README — "Always-on routing", "Enforcing the gates", and "Updating" sections.

Full changelog: https://github.com/martinholovsky/SOTA-skills/blob/main/CHANGELOG.md

v1.0.0 — first public release

First public release of SOTA-skills: 30 Claude Code skills encoding state-of-the-art (2026) practices for building and auditing software.

• 30 skills across architecture, security, APIs, performance, data, platform, and the Rust/Go/Python/JS-TS language skills, plus the sota master router.
• Every skill works in BUILD and AUDIT modes; findings carry severity + effort + standard mapping + fix; every rules file ends with an audit checklist; every file is under 500 lines.
• Per-user profiles/ (real profiles git-ignored), an audit methodology, invariant-enforcing CI + pre-commit + gitleaks, and full governance docs.

See the CHANGELOG for details. Licensed CC BY 4.0.