ai-skills

Expert guidance on Nix, NixOS, home-manager, flakes, and Nix packaging. Use when writing or debugging Nix expressions, configuring NixOS or home-manager, authoring derivations, managing flake inputs, encrypting secrets with agenix or sops-nix, or hardening a NixOS host. Triggers on Nix, NixOS, nixpkgs, home-manager, flake.nix, nixos-rebuild, nix build, nix develop, devShell, derivation, overlay, agenix, and on Nix errors such as hash mismatches, infinite recursion, or evaluation failures. Advisory rather than generative: it explains, reviews, and debugs. If the repository provides its own skill for authoring host configurations, prefer that for writing config.

Reviews Bash, Zsh, and Fish shell scripts for bugs, security vulnerabilities, portability issues, and style violations against the Google Shell Style Guide, ShellCheck, BashPitfalls, and shell-specific idiom conventions. Use when the user asks to review, audit, lint, or improve a .sh/.bash/.zsh/.fish file, or pastes shell script content for feedback.

Triage PR review comments by classifying feedback, accepting actionable suggestions, rejecting non-applicable ones with explanations, and creating tracked follow-up tasks. Use when processing code review feedback on pull requests.

Creates a draft GitHub pull request with a plain-text conventional-commit title and a succinct description of the branch. Use when the user asks to open, raise, or create a pull request or PR.

Writes brief conventional-commit messages, runs pre-commit checks, stages changes, commits them, and proposes splitting when the diff mixes concerns. Use when the user asks to commit, stage and commit, write a commit message, or split a change into atomic commits.

Creates and maintains CHANGELOG.md in Keep a Changelog format, including adding entries and cutting releases. Use when the user asks to update the changelog, add a changelog entry, or record a release.

Task decomposition expert for breaking technical specifications into atomic, implementable tasks with dependencies and priorities. Use when converting specs into actionable task lists for development teams.

Software specification expert for transforming high-level designs into detailed, implementable technical specifications. Use when converting requirements or designs into precise specs that developers can implement directly.

Senior Staff Engineer mentor for architecture, design decisions, technical mentorship, and career guidance. Use when seeking senior-level perspective on system design, code review, technical strategy, or career growth.

Engineering manager agent for orchestrating complex software development tasks by coordinating specialized sub-agents and managing parallel work streams. Use for large initiatives requiring coordination across multiple specialists.

Senior Go engineer and technical advisor — use for any Go question, design decision, or implementation task. Covers idiomatic patterns, concurrency, error handling, project structure, performance optimisation, observability, and testing. Invoke whenever the user is writing, reviewing, debugging, or designing Go code, asking about goroutines, channels, interfaces, generics, modules, or benchmarks, or wants a second opinion on a Go architecture. Triggers on: Go, Golang, goroutine, channel, interface, gRPC, go.mod, go test, pprof, golangci-lint.

Senior Go code reviewer for comprehensive code reviews focused on correctness, security, performance, and maintainability. Use when reviewing Go code for bugs, best practices, and production readiness.

Expert Go software engineer for implementing production-grade backend services with idiomatic Go patterns, testing, and observability. Use when implementing Go code following best practices.

Technical documentation expert for creating clear, comprehensive documentation including API docs (OpenAPI), ADRs, system architecture docs, developer guides, and runbooks. Use when creating or improving technical documentation.