agent-config-portability

Version, deduplicate, and migrate multi-agent skills, MCP servers, and sanitized configs across machines.

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill agent-config-portability-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-config-portability
Source: https://github.com/Chia1104/agent-air/tree/main/skills/hermes/autonomous-ai-agents/agent-config-portability
Command: npx skills add https://github.com/Chia1104/agent-air --skill agent-config-portability-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing configuration for multiple AI agents (Hermes, Claude Code, Codex, Cursor, OpenCode, Gemini) across computers leads to duplicated skills, drifting variants, and the risk of committing secrets. This Skill provides a policy and workflow for building a small, auditable repository that syncs agent settings without credentials, caches, or runtime state. ## Core Features & Use Cases - Shared skill deduplication: Canonicalize skills by declared frontmatter name, remove agent-specific duplicates, and expose shared skills via symlinks. - Secret-safe configs: Replace MCP tokens and credentials with ${ENV_VAR} references, exclude OAuth stores and sessions, and scan for leaked secrets. - Snapshot and install workflow: Deterministic snapshot scripts, dry-run-by-default installers, and cross-machine round-trip procedures with conflict policy. - Use Case: You set up a new laptop and want your Claude Code and Codex skills, MCP servers, and settings restored. Clone the portability repo, run the installer in dry-run mode, then apply skills and reauthenticate OAuth servers. ## Quick Start Ask the agent to snapshot the current machine's agent skills and configs into a secret-safe portability repository and verify there are no duplicate shared skill names.

Frequently Asked Questions about agent-config-portability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync AI agent settings across multiple computers?▼

Maintain a Git repository with canonical shared skills, agent-specific skills, and sanitized configs. Snapshot from the source machine after pulling remote changes, run tests and secret scans, then pull and run a dry-run installer on the destination machine before applying.

How to deduplicate shared skills between Claude Code and Codex?▼

Deduplicate by the declared frontmatter `name` in each SKILL.md, not by directory name or content hash. Keep one canonical copy in a shared directory, remove agent-specific copies with the same name, and symlink the shared skill into each agent.

Can I commit MCP server configs with API tokens to Git?▼

No. Replace credential values with environment variable references such as ${GITHUB_TOKEN} before committing. For OAuth MCP servers, preserve the URL and auth type but never copy token-store files; reauthenticate on the destination machine.

Does gitignore protect secrets from AI agents?▼

No. A .gitignore entry prevents accidental commits but is not an access-control boundary; agents and shell tools can still read ignored files. Use an OS keychain, password manager, or runtime injection when an agent must not receive the secret.

Why does skill deduplication miss some duplicates?▼

Content-hash-only deduplication misses modified variants, and directory-name-only checks miss nested category skills or mismatched frontmatter names. Recursively discover every SKILL.md and compare declared names against the shared set.