- Add the tool name rules of specification revision 2025-11-25 (SEP-986).
The server builder rejects an incorrect name. addTool() does not check it.
- Add URL mode elicitation with ElicitUrlRequest (SEP-1036).
- State that the SDK has no authorization for remote servers.
- State that the mcp artifact contains mcp-core and mcp-json-jackson3.
Remove the Jackson 2 option.
- Target MCP Java SDK 2.0.1 and specification revision 2025-11-25.
- Rewrite the description with user intent triggers and exclusions.
- Add the compatibility field.
- Add a five-step workflow checklist with a build loop.
- Add a Maven template, a stdio server template, and a JUnit test that
starts the server as a subprocess with the SDK client.
- Add Gotchas for SDK 2.x changes, schema validation, error results,
stdout in stdio servers, and the features that SEP-2577 deprecates.
- Add references/gradle.md for Gradle projects.
- Add references/streamable-http.md for Servlet, Spring AI, and
transport security.
- Update the skill description in docs/README.skills.md.
While implementing the Agent Plugin v1 spec in https://github.com/stbenjam/skillsaw/pull/483, I used this repository as a canonical real-world source for tests. Along the way its checks surfaced genuine correctness issues worth fixing regardless of tooling:
- Internal links that do not resolve (22): wrong relative paths, links whose targets are runtime output paths rather than bundled files (now inline code), a schemeless external URL parsed as a relative path, and links to files that do not exist (removed).
- Bundled skill files never referenced from their SKILL.md (14): each is now cited from the section where it is used, so nothing ships unreachable from the skill's instructions.
- Unclosed or mis-nested code fences (11): markdown templates embedding code blocks now use four-backtick outer fences so inner fences nest instead of closing the template early and leaking example content as live markdown; also removed stray orphan fences and closed an unterminated block at end of file.
- Invisible unicode (1): removed a zero-width space from a code example, a copy-paste artifact invisible to reviewers.
Burak Kaygusuz
Stephen Benjamin
copilot-swe-agent[bot]andaaronpowell