@noodleseed/agent-kit

Self-checking, self-updating agent skills for the Noodle Seed CLI.

This package is the canonical, independently-versioned skills artifact the noodle CLI fetches and verifies. It is not meant to be imported directly by apps — it is shipped as data the CLI reconciles into a project's .agents/ and .claude/ skill directories via noodle agents setup --write.

Contents

• skills/codex/ — the Codex (Codex CLI / AGENTS.md) skill: a SKILL.md router plus fourteen references/*.md files (sdk-surface, cli-commands, agent-contract, compile-errors, authoring-workflow, connect-an-api, experience-design, widgets-and-apps, test-in-hosts, troubleshooting, deploy-and-ops, publishing, chatgpt-compliance, examples).
• skills/claude-code/ — the Claude Code skill, same hierarchical tree.
• manifest.json — { packageVersion, files: [{ path, sha256, agentTarget }] }. The CLI verifies every file's sha256 against this manifest before writing it into a user's project; a mismatch refuses the write. The manifest and every generated skill file are available in the public source tree for inspection.

How the CLI uses it

The installed noodle CLI bundles a skills snapshot at its release version. On interactive runs it also checks @noodleseed/agent-kit@latest on the npm registry and, when newer, prompts:

Skills updated in vX — run `noodle agents setup --write` to refresh.

noodle agents setup --write then fetches this package, sha256-verifies it against the manifest, and writes the fresh skill tree into the project (the managed AGENTS.md/CLAUDE.md block stays bundled, since it is project-specific). Offline or on verification failure it falls back to the bundled snapshot. Run noodle agents doctor to see installed vs registry skill versions and detect local edits to bundled reference files.

License

Apache-2.0. This package is generated and published from the noodle-core repository; the renderer is the @noodle-borg/agent-kit workspace package.