negz/nix

git-commits

Write git commits in Nic Cope's style. Use when creating commits, staging changes for commit, or when the user asks to commit. Includes Signed-off-by requirements and problem-first messaging.

writing-style

Write and edit documents in Nic Cope's voice and style. Use when drafting designs, one-pagers, PRDs, proposals, explorations, blog posts, or any prose document. Also use when tightening, de-slopping, or copy editing prose, whether yours, Nic's, or someone…

github-issues

Create GitHub issues in Nic Cope's style. Use when opening, creating, or filing issues, bug reports, feature requests, or proposals. Uses gh CLI and respects issue templates.

github-pull-requests

Create and manage GitHub pull requests in Nic Cope's style. Use when creating, opening, or drafting PRs, or updating PR descriptions. Uses gh CLI.

adversarial-review

Review non-trivial code changes in a fresh context before committing. Use before committing new features, non-trivial bug fixes, refactors, or any change where correctness matters. Also use when the user asks for a review or sanity check. Do not use for typo…

before-writing-code

Core engineering principles to apply before beginning implementation in any language. Read at the start of a coding session, before writing the first new code, refactor, or change to existing code. Establishes how to approach a codebase, design for change,…

negz-review

Review code and docs the way negz reviews them - naming, Go idiom, Kubernetes API conventions, simplicity (YAGNI), consistency with existing patterns, testing style, comments, and compatibility. Use when reviewing a PR or diff, when asked for a review or…

go-code-factoring

Factor and structure Go code for clarity, testability, and composability. Use when writing new Go code, refactoring existing code, reviewing code structure, adding interfaces, decomposing large functions or structs, or when the user mentions factoring,…

go-unit-tests

Write unit tests for Go code. Use when creating, adding, or updating Go tests, writing table-driven tests, creating mocks or fakes, adding test coverage, or when the user mentions testing, cmp.Diff, assertions, or test cases. Also use when reviewing whether…

no-shortcuts

Resist the temptation to defer hard problems in greenfield work. Use when starting a new project, building a new feature or subsystem, prototyping, or doing any work where feasibility is uncertain. Also use when considering deferring something because it's…

source-verification

Verify APIs and library usage against actual documentation before writing code. Use when introducing a new dependency, using an API not already established in the codebase, upgrading a library version, or when unsure whether an API exists or works as…

crossplane-python-functions

Write Python composition functions for Crossplane v2 using the up CLI. Use when writing, debugging, or refactoring composition functions, when working with the compose(req, rsp) pattern, when dealing with required resources, readiness tracking, resource…

github

Interact with GitHub using the gh CLI. Use when viewing PRs, checking CI status, reviewing code, listing issues, or any GitHub operation. Prefer gh over web fetching.

krm-api-design

Design Kubernetes Resource Model (KRM) APIs - CRDs and XRDs. Use when designing, reviewing, or evolving custom resource schemas, composite resource definitions, OpenAPI v3 schemas for Kubernetes, or when the user mentions CRD design, XRD design, API schema…

nix-flake

Develop projects that use a Nix flake. Use when building, testing, linting, running dev commands, or entering a dev shell for a project that has a flake.nix. NOT for running ad-hoc CLI tools - use nix-tools for that.

nix-tools

Run any CLI tool via Nix - assume tools like jq, yq, ripgrep, and fd are available. Use CLI tools freely for JSON/YAML processing and searching. Also use when a command is not found.

scratch-docs

Draft, publish, and iterate on markdown documents in the upbound/scratch repo. Use when the user wants to draft a document (PRD, design, exploration, R&D notes), open a PR for review, read review comments, or iterate on a scratch document. Also use when the…

skill-creator

Create new skills, modify and improve existing skills. Use when users want to create a skill from scratch, turn a workflow into a skill, update or optimize an existing skill, improve a skill's description for better triggering accuracy, or when they mention…

tmux-ssh-socket

Fix SSH authentication failures in tmux sessions. Use when git push, git pull, git fetch, ssh, or scp fails with authentication, permission denied, or socket errors inside tmux. Also use when the user mentions SSH agent forwarding, SSH_AUTH_SOCK, or stale SSH…