Skills and Capabilities

Environment Skills

Nix Package Management

• Install/remove packages via nix profile
• Build derivations with nix build
• Enter development shells with nix develop / nom develop
• Check flake validity with nix flake check
• Update dependencies with nix flake update

Pixi Package Management

• Add packages: pixi add <package>
• Remove packages: pixi remove <package>
• Search packages: pixi search <pattern>
• Update lockfile: pixi update
• Show environment: pixi info

Shell Navigation

• Smart directory navigation with zoxide (z <path>)
• Fuzzy file finding with fzf
• File listing with eza (modern ls)
• File viewing with bat (modern cat)
• Ripgrep for fast searching (rg <pattern>)

Development Skills

ROS2 Development

• Build packages: colcon build --symlink-install
• Run tests: colcon test
• View results: colcon test-result --verbose
• Launch nodes: ros2 launch <package> <launch_file>
• Topic inspection: ros2 topic list/echo/info
• Service calls: ros2 service call
• Parameter management: ros2 param

Git Operations

• Standard git workflow (add, commit, push, pull)
• GitHub CLI operations with gh
• PR creation: gh pr create
• Issue management: gh issue
• Workflow inspection: gh run

Code Editing

• Helix editor with LSP support
• Language servers for: Python, C++, CMake, Nix, YAML, XML, Rust, Bash, TOML, Markdown
• Auto-completion, go-to-definition, hover docs
• Code formatting and linting

Build Skills

CMake Projects

• Configure: cmake -B build -G Ninja
• Build: cmake --build build
• Install: cmake --install build
• Test: ctest --test-dir build

Python Projects

• Virtual environments via Pixi
• Package installation: pixi add <package>
• Running scripts: pixi run python <script>
• Testing: pixi run pytest

C++ Projects

• Compilation with gcc/clang
• Debug builds with symbols
• Release optimization
• Static analysis with clang-tidy

Rust Projects

• Package management with cargo
• Build: cargo build / cargo build --release
• Test: cargo test
• Format: cargo fmt
• Lint: cargo clippy
• LSP support via rust-analyzer

AI/Inference Skills

LocalAI (Local LLM Inference)

• OpenAI-compatible API server
• Start: localai start
• Stop: localai stop
• Check: localai status
• List models: localai models
• Default port: 8080

AGiXT (AI Agent Platform)

• Docker-based agent automation
• Start: agixt up
• Stop: agixt down
• Logs: agixt logs
• Status: agixt status
• Shell: agixt shell
• API port: 7437, UI port: 3437

AIOS (Agent Operating System)

• User-space agent kernel with syscalls
• Install: aios install
• Start: aios start
• Stop: aios stop
• Status: aios status
• Config: aios config
• Default port: 8000
• Pixi environment: pixi run -e aios ...

Cerebrum (Agent SDK)

• SDK for building AIOS agents
• Install: pip install aios-agent-sdk
• Run agent: run-agent --mode local --agent_path ./my_agent --task "..."
• List agents: list-agenthub-agents
• Download agent: download-agent
• Upload agent: upload-agents

DevOps Skills

CI/CD

• GitHub Actions workflow creation
• Workflow debugging and monitoring
• Secret management
• Artifact handling

Container Operations

• Build images with Docker/Podman
• Multi-stage builds
• Layer optimization
• Registry push/pull

Infrastructure

• Nix-based system configuration
• Home-manager user configuration
• Cross-platform deployments
• Reproducible environments

Automation Skills

Shell Scripting

• Bash script creation and debugging
• Nushell for structured data
• PowerShell for Windows automation
• Cross-platform script patterns

Task Automation

• File watching and triggers
• Scheduled tasks
• Event-driven automation
• Workflow orchestration

Analysis Skills

Code Analysis

• Static analysis with various linters
• Dependency scanning
• Security vulnerability detection
• Performance profiling

Log Analysis

• Pattern matching with ripgrep
• Structured log parsing
• Error aggregation
• Trend detection

Communication Skills

Documentation

• Markdown formatting
• Code documentation
• API documentation
• User guides and tutorials

Reporting

• Status summaries
• Progress reports
• Error explanations
• Recommendations

Command Types

Commands are available from three sources - understand where they come from:

Devshell Commands (flake.nix)

Available inside nix develop / nom develop:

Shell Aliases (modules/common/packages.nix)

Available in all shells via home-manager:

AI Assistant Aliases (modules/common/packages.nix)

Available in all shells via home-manager:

Nix Commands (system-wide)

Available after Nix installation:

Tool Quick Reference

Skill Expansion

New skills can be added by:

1. Nix packages: Add to flake.nix or modules/common/packages.nix
2. Pixi packages: Add via pixi add <package>
3. Structured skills: Add to .claude/skills/<skill-name>/SKILL.md
4. Slash commands: Add to .claude/commands/<command>.md
5. Shell aliases: Add to modules/common/packages.nix shellAliases
6. Devshell commands: Add to flake.nix devshells.default.commands
7. Editor plugins: Configure in modules/common/editor/default.nix

Skill File Format

Skills use YAML frontmatter for agent discovery:

---
name: skill-name
description: What this skill does
icon: 📦
category: development
tools:
  - tool1
  - tool2
---

# Skill Documentation
...

Limitations

Current limitations to be aware of:

• GUI applications require display forwarding in WSL2
• Some ROS packages may not be available in RoboStack
• Hardware access (USB, serial) needs additional configuration
• GPU acceleration requires driver setup