Skip to content

chore: commit agent skills and MCP configs for Claude Code, Codex, Cursor and Antigravity - #26

Merged
vlidholt merged 1 commit into
serverpod:mainfrom
vlidholt:chore/agent-setup
Oct 20, 2026
Merged

vlidholt merged 1 commit into
serverpod:mainfrom
vlidholt:chore/agent-setup

Conversation

@vlidholt

Copy link
Copy Markdown
Contributor

Maintainer change, no board task.

Summary

A fresh checkout is now ready for agentic coding with Claude Code, Codex, Cursor and Antigravity. Until now the agent setup was git-ignored and existed only for Claude Code on one machine, although CONTRIBUTING.md and spec 16 already said .mcp.json was in the repo. The setup is adopted from a newly created Serverpod project, with the MCP servers pointed at wonky_server:

  • Skills (the 44 Flutter, Serverpod, Relic, PetitParser and synchronized skills): .claude/skills/ (Claude Code), .agents/skills/ (Codex, Antigravity) and .cursor/skills/ (Cursor). The copies are the same except that the Claude Code copy marks them user-invocable: false.
  • MCP (serverpod with --server-dir wonky_server, and dart): .mcp.json (Claude Code), .codex/config.toml, .cursor/mcp.json and the .agents/plugins/serverpod-local/ plugin.
  • .gitignore: the agent directories are no longer ignored. Still ignored: .dart_skills/ (the skills tool's cache, which contains nested git clones), .claude/settings.local.json and .claude/worktrees/ (per machine), .gemini/ and .vscode/mcp.json.
  • passwords.example.yaml: the CHANGE_ME values become distinct 32-character development values, so the copied file works as it is. Serverpod rejects peppers shorter than 10 characters, and CHANGE_ME is only 9. The header comment says these values are for local development and tests only and must never be reused.
  • Docs: CONTRIBUTING.md no longer says to replace CHANGE_ME and lists the agent config for each platform. The contribute page's step 5 text is updated (ARB, pseudo-locale and gen-l10n regenerated). The specs/01-architecture.md layout now includes the agent directories.

Test plan

  • The skills are identical to the reference project's; the MCP configs differ only in wonky_server
  • All JSON and TOML configs parse; passwords.example.yaml parses and every value is 32 characters
  • flutter test test/board/pages in wonky_app passes; the regenerated l10n files are dart format clean
  • Fresh clone opened in Codex, Cursor and Antigravity: the skills and both MCP servers show up (not checked by the agent)

🤖 Generated with Claude Code

…rsor and Antigravity

A fresh checkout is now ready for agentic coding. Adopted from a newly
created Serverpod project, with the MCP servers pointed at wonky_server:

- Skills: .claude/skills (Claude Code), .agents/skills (Codex,
  Antigravity) and .cursor/skills (Cursor).
- MCP: .mcp.json (Claude Code), .codex/config.toml, .cursor/mcp.json and
  the .agents/plugins/serverpod-local plugin, each with the serverpod and
  dart MCP servers.
- .gitignore keeps only the skills manager's cache (.dart_skills/) and
  per-machine Claude settings out.

passwords.example.yaml: the CHANGE_ME values become 32-character
development values, so the copied file works as it is (Serverpod rejects
peppers shorter than 10 characters). CONTRIBUTING.md, the contribute
page's step 5 and specs/01 are updated to match.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vlidholt
vlidholt merged commit 1057c8a into serverpod:main Oct 20, 2026
41 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Oct 20, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant