AGENTS.md
+10 −7
https://raw.githubusercontent.com/cyanheads/wikidata-mcp-server/HEAD/AGENTS.md
− **Version:** 0.2.0− **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.15`− **MCP SDK:** `@modelcontextprotocol/server` ^2.3.1− **Zod:** ^4.6.5− Skills are modular instructions in `framework-skills/` at the project root. Read them directly when a task matches — e.g., `framework-skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry. The directory is deliberately not `skills/`: Claude Code and Codex auto-load a plugin's root `skills/`, so a server that ships `.claude-plugin/` or `.codex-plugin/` would hand these development skills to every agent that installs it. Keep `skills/` free for skills meant f− | `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity (run by devcheck) |− `npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips two classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`) and platform-specific native bindings, which would otherwise lock the bundle to the platform it was + **Version:** 0.3.0+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.18`+ **MCP SDK:** `@modelcontextprotocol/server` ^2.4.0+ **Zod:** ^4.6.7+ Two skill trees serve different readers: `framework-skills/` holds development guidance synced from the framework; root `skills/` holds the published `wikidata-guide` for agents using the server. Read development skills when a task matches — e.g., `framework-skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the registry. Plugin installs, npm, Docker, and MCPB deliver root `skills/`; `createApp({ skills: 'skills' })` serves it over MCP. `lint:packaging` validates that tre+ | `add-skill` | Author a published skill in root `skills/` — structure, validation, and delivery |+ | `bun run lint:packaging` | Packaging checks — env-var parity, bundle contents, plugin manifests, published skills (run by devcheck) |+ `bun run bundle` produces a `.mcpb` for Claude Desktop. Root development paths in `.mcpbignore` must be anchored (`/docs/`, never `docs/`); root `skills/` ships. After `mcpb clean` prunes dev dependencies, `scripts/clean-mcpb.ts` strips installed-package-root agent docs, platform-specific native bindings, node-gyp build output, and build-only framework files. Its agent-doc matcher preserves nested runtime modules such as the SDK's `dist/ext/skills/`; keep it aligned with the packaging linter and+ - [ ] Root `plugin.json` and `mcp.json` match Agent Plugins 1.0.0; identity and version match the package, stdio installs the full npm name, and fixed `env` matches the Codex overlay. Keep `.codex-plugin/plugin.json`'s `mcpServers` pointer so Codex forwards `env_vars`.+ - [ ] Published `skills/` passes packaging validation and ships through npm, Docker, plugin installs, MCPB, and MCP; field-test its gates and identifier claims.