Agent skill
sync-pull
Use when the user wants to restore, download, or pull their Claude Code config from GitHub onto this machine.
Install this agent skill to your Project
npx add-skill https://github.com/rohithzr/claudebase/tree/main/skills/sync-pull
SKILL.md
Config Sync Pull
Pull configuration from your GitHub backup repo and apply it to the local machine.
What happens
- Backup — Current local config is backed up to plugin data directory (timestamped, keeps last 10)
- Apply shared — Files from
shared/directory are applied first (base layer) - Apply profile — Profile-specific files overlay on top (overrides shared where both exist)
- Apply global — User-level settings from
global/are applied to~/.claude/ - Verify — JSON config files are validated for correct syntax
Instructions
Parse user arguments and run the pull script:
bash "${CLAUDE_PLUGIN_ROOT}/scripts/sync-pull.sh" [OPTIONS]
Options:
--profile NAME— Pull a specific profile (default: active profile)--dry-run— Show what would be applied without writing any files--no-backup— Skip backup step (use with caution)--yes/-y— Skip confirmation prompt (auto-approve)--include-global— Also pull~/.claude/settings.json(global settings are opt-in)
Profile switching
If the user specifies a different profile than their current one, this effectively switches their setup. Let them know which profile they're switching from/to.
After pull
Tell the user:
- How many files were applied
- Any validation warnings
- That a backup was created (and where)
- They may need to restart Claude Code for some settings to take effect
User Arguments
$ARGUMENTS
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
rohithzr/claudebase
sync-push
Use when the user wants to back up, save, or push their current Claude Code config to GitHub.
rohithzr/claudebase
sync-config
Use when the user wants to view or change claudebase settings like global sync, agent skills sync, auto-push, or machine ID.
rohithzr/claudebase
sync-setup
Use when the user wants to set up config sync for the first time, connect to GitHub, or re-initialize the backup repo.
rohithzr/claudebase
sync-profiles
Use when the user wants to list, create, switch, delete, compare, or inspect config sync profiles.
rohithzr/claudebase
sync-status
Use when the user wants to check what config has changed, see sync status, or compare local vs remote config.
mattpocock/skills
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
Didn't find tool you were looking for?