Changelog

All notable changes to this project are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Added

• #8: plugin.json, declaring this repository as an Agent Plugin.
• scripts/eval-routing.sh and evals/routing.tsv, checking that a prompt reaches the skill it should. Routing happens on descriptions alone, and with eighteen skills they had started to compete. Works with any OpenAI-compatible endpoint, including a local one, and calls Anthropic directly when none is configured.
• validate-skills.sh rejects a frontmatter value containing an unquoted ": ", which breaks YAML parsing and shows up as an unhelpful parse error.
• validate-skills.sh requires every skill to have a routing case, so the case file cannot fall behind the skill set.
• #8: validate-skills.sh checks that the .claude/skills compatibility path still resolves to skills/, and that plugin.json and CHANGELOG.md agree on the version.
• Install with npx skills@latest add decebals/claude-code-java, for the skills alone. The setup script stays the path for the full workspace.

Changed

• Sharpened the descriptions of clean-code, solid-principles and spring-boot-patterns, which overlapped enough to send prompts to the wrong skill. Each now says where it stops and which skill takes over.
• #8: Skills moved from .claude/skills/ to skills/, which is where the Agent Plugins standard expects them. .claude/skills remains as a symlink, so existing links and the paths in our own documentation keep working. On a checkout without symlink support, Windows without developer mode being the usual case, use skills/ directly.

Fixed

• Skill Review no longer runs on pull requests from forks, where it could only fail: secrets are not passed to fork runs, and the action refuses an actor without write access.

1.0.0 - 2026-08-28

First tagged release. Within a major version, skill names and directory layout stay put, which is what copying or symlinking a skill folder depends on.

Added

• 18 skills covering workflow, code quality, architecture and frameworks. The skills README lists them.
• Setup scripts: setup-project.sh, link-skills.sh, generate-claude-md.sh, configure-mcp.sh, configure-settings.sh, test-all.sh.
• Templates for CLAUDE.md, MCP configuration and Claude Code settings.
• Skill review workflow that evaluates changed skills against docs/SKILL_GUIDELINES.md.
• #5: Compliance with the Agent Skills specification. scripts/validate-skills.sh checks the hard requirements with no dependencies, and CI also runs the reference validator from the spec authors.
• #5: license: MIT in every skill's frontmatter, so the license travels with a folder copied out of this repo.
• #5: Test workflow running the script suite and spec validation on pull requests and on main.

Changed

• #5: The README describes the project by the open format it follows rather than by one client. Claude Code remains where the skills are developed and tested.
• #5: The skill review prompt no longer checks structure, which the validators now do deterministically and for less.

Fixed

• #5: The check example in docs/TESTING.md had its arguments reversed, so following it produced a test that always reported the wrong result.