pypeaday/dotfiles

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

drawio-skill

Create, edit, synchronize, inspect, test, and publish editable draw.io diagrams. Use when the user explicitly requests draw.io/diagrams.net, needs a polished architecture, ERD, UML, sequence, C4, SysML, BPMN, network, swimlane, ML, or infrastructure diagram,…

grill-me

A relentless interview to sharpen a plan or design.

grill-with-docs

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

handoff

Compact the current conversation into a handoff document for another agent to pick up.

implement

Implement a piece of work based on a spec or set of tickets.

implement-spec

Implement the result of /to-spec and /to-tickets in code.

improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

loop-me

Grill me about specs for the workflows I want to build, within this workspace.

retro

Conduct a retrospective on a coding session.

setup-matt-pocock-skills

Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

setup-ts-deep-modules

Wire dependency-cruiser into a TypeScript repo so each package is a deep module, with implementation hidden in subfolders and reachable only through its entry-point files. User-invoked.

teach

Teach the user a new skill or concept, within this workspace.

to-questionnaire

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

to-spec

Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've already discussed.

to-tickets

Break a plan, spec, or the current conversation into a set of tracer-bullet tickets, each declaring its blocking edges, published to the configured tracker (edges as text in one file per ticket locally, or native blocking links on a real tracker).

triage

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

wait-what

Stop. That last message did not land: re-pitch it.

wayfinder

Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.

writing-beats

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

writing-fragments

Writing, explore: mine raw fragments, no structure yet.

writing-shape

Writing, exploit: shape raw material into an article, paragraph by paragraph.

flow

ADHD-friendly focus loop for coding sessions. Use when the user wants to vibe-code or build something, brings a fuzzy or sprawling idea, feels scattered or stuck, says 'where were we' / 'keep me on track' / 'get in flow', or resumes work they lost the thread…

update-skills

Update the installed mattpocock/skills to the latest upstream version. Use when the user wants to update, refresh, or pull new versions of the installed agent skills.

airflow

Airflow DAG patterns, KubernetesPodOperator, and debugging. Triggers on "dag", "airflow", "task", "operator", "KPO", "scheduler", "XCom".

aws-iam

Create and debug AWS IAM policies with least-privilege. Triggers on "IAM policy", "permission denied", "access denied", "not authorized", "create role".

aws-infra

Read-only AWS infrastructure discovery using AWS CLI. Triggers on "list instances", "show buckets", "describe vpc", "what's in this account", "check IAM roles", or any AWS resource lookup. Supports multi-account via --profile.

code-review

Ruthless code review for Python, Kubernetes, and AWS. Hunts for downstream problems, security issues, and unnecessary complexity. Triggers on "review", "check", "audit", "what could go wrong", "done yet", "ready to merge".

devops

CI/CD, Infrastructure as Code, containers, GitOps, monitoring, and release strategies. Triggers on "CI/CD", "pipeline", "terraform", "docker", "dockerfile", "github actions", "gitops", "monitoring", "incident".

drawio

Create architecture diagrams with draw.io MCP server. Use on 'diagram', 'architecture', 'drawio', 'flowchart', 'visualize'.

git

Git operations including commits, branches, worktrees, and safety protocols. Use on 'git', 'commit', 'branch', 'worktree', 'rebase', 'merge'.

helm

Helm chart policies, bitnami legacy repo, and release management. Use on 'helm-skill' or 'load helm skill'.

k8s-security

Kubernetes security best practices for manifests and Helm charts. Use on 'k8s security', 'manifest audit', 'helm security review', 'pod hardening'.

k8s-troubleshoot

Systematic Kubernetes troubleshooting for pods, nodes, networking, storage, and control-plane issues. Triggers on "pod not starting", "crash loop", "OOMKilled", "debug k8s", "why is pod failing", "ImagePullBackOff", "CrashLoopBackOff", "kubectl describe".

mcp

Build MCP servers and tools with Python FastMCP SDK. Triggers on "mcp", "mcp server", "mcp tool", "fastmcp", "model context protocol".

minimal-build

Build Python/K8s/AWS with minimal code. Every line is a liability. Triggers on "build", "implement", "add", "create", "deploy". Prioritizes deletion, reuse, and configuration over new code.

python

Python development patterns, testing, async, data modeling, and debugging. Triggers on "python", "pytest", "pydantic", "async", "fastapi", "type hint", "dataclass".

python-uv

Python tooling with uv: project management, scripts, packages, and CI. Triggers on "uv", "pyproject", "python setup", "pip install", "virtual environment", "python project".

steampipe-aws

Query AWS infrastructure using steampipe SQL. Triggers on "what resources", "find instances", "list buckets", "show IAM", "audit AWS", "security groups", or any AWS resource discovery task.