Skip to content

docs(plugin): explain updates and Git recovery - #584

Merged
christso merged 1 commit into
mainfrom
docs/managed-skill-updates
Oct 21, 2026
Merged

christso merged 1 commit into
mainfrom
docs/managed-skill-updates

Conversation

@christso

Copy link
Copy Markdown
Contributor

Explains how to keep custom skills durable: edit the declared source or a fork, and use committed Git snapshots to recover installed project copies that updates may replace. The quick start now shows Claude-only installation, adding Codex, updating, and uninstalling.

The guidance covers ordinary file installs, points to profile-specific protections, and distinguishes client destinations, ignored paths, symlinks, and user-global files. Runtime behavior is unchanged.

Validation

  • bun install --frozen-lockfile — built the production CLI.
  • bun run docs:build — passed; checked the rendered sections, Git commands, and cross-page anchors.
  • Used a disposable project and isolated HOME/ALLAGENTS_TEST_HOME with a local plugin containing skills/review/SKILL.md. Exercised the built node dist/index.js with workspace init . --client claude, plugin install <fixture> --scope project --client claude --yes, reinstall for --client claude,codex, update --scope project, and plugin uninstall <fixture> --scope project. Source edits reached both clients and uninstall removed the installed copies.
  • In a separate Universal-client fixture, committed .allagents/workspace.yaml and .agents/skills/, verified git diff -- .agents/skills/ and git restore --source=HEAD -- .agents/skills/, and confirmed ordinary update replaces direct edits and uninstall removes modified installed copies.
  • Independent read-only documentation fact-check found no inaccuracies; git diff --check passed.

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying allagents with  Cloudflare Pages  Cloudflare Pages

Latest commit: 5b31ed8
Status: ✅  Deploy successful!
Preview URL: https://ed2237d1.allagents.pages.dev
Branch Preview URL: https://docs-managed-skill-updates.allagents.pages.dev

View logs

@christso
christso merged commit 9bf0620 into main Oct 21, 2026
8 checks passed
@christso
christso deleted the docs/managed-skill-updates branch October 21, 2026 00:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant