Agent skill
debian-bootstrap
Bootstrap a new Debian/Ubuntu system with your standard configuration. Portable dotfiles, SSH config, shell setup, and SOPS secrets - no Nix required. Use when setting up a new machine or migrating away from NixOS.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/design/debian-bootstrap-cptfinch-dotfiles
SKILL.md
Debian Bootstrap
Recreate your development environment on any Debian/Ubuntu system.
Quick Start
cd ~/.claude/skills/debian-bootstrap
just # See all commands
just setup-all # Full setup (packages + tools + dotfiles + secrets)
First time? See BOOTSTRAP.md for the complete checklist including manual steps (age key, secrets.yaml).
Architecture
┌─────────────────────────────────────────────────────────────────┐
│ debian-bootstrap │
├─────────────────────────────────────────────────────────────────┤
│ apt (packages.txt) │ System packages (git, curl, htop) │
├─────────────────────────────────────────────────────────────────┤
│ mise (mise.toml) │ Everything else: │
│ │ - Languages: node, python │
│ │ - CLI: bat, fd, rg, delta, lazygit │
│ │ - Cloud: gh, hcloud, awscli │
├─────────────────────────────────────────────────────────────────┤
│ uv │ Python package management │
├─────────────────────────────────────────────────────────────────┤
│ SOPS/Age │ Encrypted secrets │
└─────────────────────────────────────────────────────────────────┘
Two bootstrappers, one config file:
misemanages all dev tools viamise.tomluvhandles Python packages (10-100x faster than pip)
What's Included
| Component | Source | Target |
|---|---|---|
| Dev tools | mise.toml |
~/.config/mise/config.toml |
| SSH config | dotfiles/ssh_config |
~/.ssh/config |
| Bash config | dotfiles/bashrc |
~/.bashrc |
| Git config | dotfiles/gitconfig |
~/.gitconfig |
| Starship prompt | dotfiles/starship.toml |
~/.config/starship.toml |
| System packages | packages.txt |
via apt |
| SOPS setup | scripts/setup-sops.sh |
~/.config/sops/ |
Commands
# Full setup
just setup-all # Everything in order
# Individual components
just install-packages # apt packages only
just install-extras # mise + uv + all dev tools
just install-dotfiles # All dotfiles
just setup-sops # SOPS/Age encryption
# Secrets & Auth
just decrypt-ssh-keys # Extract SSH keys + add to agent
just setup-gh-auth # Authenticate GitHub CLI
just setup-glab-auth # Authenticate GitLab CLI
# Tool management (after setup)
mise install # Install tools from mise.toml
mise upgrade # Update all tools
mise list # Show installed tools
File Structure
debian-bootstrap/
├── SKILL.md # This file
├── BOOTSTRAP.md # Step-by-step first-time setup guide
├── justfile # All commands
├── mise.toml # Dev tools (the source of truth)
├── packages.txt # apt packages (system only)
├── dotfiles/
│ ├── ssh_config
│ ├── bashrc
│ ├── gitconfig
│ └── starship.toml
└── scripts/
├── install-extras.sh # Installs mise, uv, then mise install
└── setup-sops.sh # SOPS/Age setup
Adding Tools
Edit mise.toml and run mise install:
[tools]
# Languages
node = "lts"
python = "3.12"
go = "latest"
# CLI tools via ubi (GitHub releases)
"ubi:sharkdp/bat" = "latest"
"ubi:jesseduffield/lazygit" = "latest"
Secrets Management
Uses SOPS with Age encryption (same as NixOS setup):
# Decrypt secrets
sops -d ~/.claude/secrets.yaml
# Edit secrets
sops ~/.claude/secrets.yaml
# Extract single secret
sops -d --extract '["github_token"]' ~/.claude/secrets.yaml
Migration from NixOS
This skill was generated from your NixOS/Home Manager config. All Nix-specific paths have been converted to standard locations.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?