Add agent-assisted AgentCairn setup through skills.sh

[ccf]

Summary

• add a public agentcairn-setup skill for skills.sh and find-skills users
• keep native plugins and cairn install as the source of truth for runtime, MCP, hook, and config changes
• hide the plugin-delivered memory behavior from normal skills.sh discovery and fail closed when its MCP tools are missing
• add isolated distribution coverage, expand the plugin workflow, update docs/changelog, bump native plugin patch versions, and correct the Hermes reindex example

Why

skills.sh installs Agent Skill directories; it does not install AgentCairn's Python runtime, MCP registration, native plugins, or lifecycle hooks. The repository's existing runtime behavior skill was discoverable there, but a standalone copy could only instruct agents to call tools that were not installed.

This PR introduces a separate setup-management skill that detects the target harness, previews one targeted native install, delegates all mutations to AgentCairn's existing installer, and verifies each supported integration layer. It avoids duplicating host configuration logic or presenting a skills.sh install as the full product.

User and developer impact

• users can install agentcairn-setup through skills.sh and ask their agent to configure or repair AgentCairn
• canonical Claude Code and Codex plugin installation remains the shortest path
• MCP-host previews are handled privately because merged preview output can contain unrelated server credentials
• using-agentcairn-memory remains available through native plugins, while normal skills.sh discovery exposes only the setup assistant
• native manifests advance to Claude Code 0.4.1, Codex 0.1.3, and Antigravity 0.1.2

Validation

• uv run pytest -q — 766 passed, 5 skipped
• targeted plugin and distribution suite — 37 passed
• Ruff format and lint, YAML validation, diff checks, skill validators, and Claude plugin validation passed
• pinned skills@1.5.19 isolated install found exactly agentcairn-setup and copied only SKILL.md plus agents/openai.yaml
• isolated Codex 0.144.5 plugin installation confirmed the internal runtime skill still loads through the native plugin
• forward-tested missing Codex tools, secret-bearing Cursor configuration, and mixed Claude Code/Antigravity setup flows

---

Note

Low Risk
Changes are mostly documentation, skill metadata, CI guards, and patch manifest bumps; install behavior still goes through the existing cairn install path rather than new runtime code.

Overview
Introduces a public agentcairn-setup skill (plus Codex openai.yaml) for skills.sh users: it detects the harness, previews a single targeted install, runs uvx --from agentcairn cairn install, and verifies plugin/MCP, restart, and loaded tools—without bundling runtime, MCP, plugins, or hooks.

using-agentcairn-memory (plugin and src/cairn/assets copy) is marked metadata.internal: true and now stops if recall/remember are missing, pointing agents to $agentcairn-setup instead of implying a standalone skill installed AgentCairn.

The plugin workflow widens path triggers, runs test_plugin_assets / test_skill_distribution, and adds a pinned skills@1.5.19 isolated install check that only copies setup files and not the runtime skill. README, CHANGELOG, and Hermes reindex docs are updated; native plugin versions bump (Claude 0.4.1, Codex 0.1.3, Antigravity 0.1.2).

^{Reviewed by Cursor Bugbot for commit 21b7324. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	agentcairn	21b7324	Commit Preview URL Branch Preview URL	Jul 17 2026, 02:12 PM