Manage personal macOS organization files, system configurations, security tools, and AI assistant rules. Includes git-secrets setup, macOS defaults management, and Homebrew package automation.
Manage and configure a personal macOS environment with organization files, system settings, security tooling, and AI assistant operational rules.
This skill helps you work with a repository that centralizes:
Set up comprehensive git-secrets protection across all repositories:
1. **Global setup**: Run `./setup-git-hooks.sh` to configure git-secrets globally with automatic pre-commit hooks
2. **Per-repository setup**: Use `./apply-git-hooks.sh /path/to/repository` to add security hooks to existing projects
3. **Historical scanning**: Execute `./scan-repo-for-secrets.sh /path/to/repository` to audit git history for leaked credentials
4. **Prevention patterns**: All scripts automatically detect AWS keys, API tokens, private keys, and other sensitive patterns
Apply and manage declarative system preferences:
1. **Apply settings**: Run `./defaults_settings.sh` to configure macOS system defaults (Dock, Finder, keyboard, trackpad, etc.)
2. **Export current settings**: Use `./export_defaults.sh` to capture current macOS configuration into version-controlled scripts
3. **Package management**: Modify `Brewfile` for applications and tools, then run `brew bundle install --file=Brewfile`
4. **Repeatability**: All configurations are scriptable for new machine setup or system rebuilds
The repository uses a unified rules system:
1. **Document changes**: Update corresponding `.md` files when changing configurations
2. **Test scripts**: Verify shell scripts work before committing
3. **Brewfile changes**: Always run `brew bundle install` after modifying `Brewfile`
4. **Defaults changes**: Test `defaults_settings.sh` on non-critical settings first
1. **Never commit secrets**: All scripts are pre-configured to prevent credential leaks
2. **Use environment variables**: Store sensitive data in `.env` files (globally gitignored)
3. **Regular audits**: Periodically run `scan-repo-for-secrets.sh` on important repositories
4. **Global protection**: Install git-secrets globally so all new repositories inherit protection
1. **Follow existing patterns**: Match naming conventions and structure
2. **Add documentation**: Include usage instructions in comments and corresponding `.md` files
3. **Update CLAUDE.md**: Add new commands or architecture changes to this context file
4. **Test security hooks**: Ensure new scripts don't trigger false positives in git-secrets
```bash
./setup-git-hooks.sh
./defaults_settings.sh
brew bundle install --file=Brewfile
```
```bash
./scan-repo-for-secrets.sh /path/to/repository
./apply-git-hooks.sh /path/to/repository
```
```bash
./export_defaults.sh
git diff defaults_settings.sh
./defaults_settings.sh
```
This repository serves as a living configuration system for personal macOS environments. All changes should maintain:
When working with this repository, prioritize maintaining the security infrastructure and documentation quality over adding new features.
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/personal-macos-organization/raw