A collection of personal AI coding assistant configurations, specialist agents, and automated workflows optimized for Python and ML open-source development.
Agent
Adversarial review — drills to bedrock, treats claims as unproven until evidence. NOT for: plan design (foundry:solution-architect), test coverage (foundry:qa-specialist), config formatting (foundry:curator). TRIGGER: "challenge this", "devil's advocate", "poke holes in". SKIP: wants implementation; recursive call…
Agent
Content specialist — blog posts, slide decks, social threads, talk abstracts. Reads approved outline, applies four-beat arc. NOT for in-code docs/README/FAQs (foundry:doc-scribe), release notes (oss:release). TRIGGER: "write a blog post", "create slides", "draft a thread". SKIP: no outline; doc task; reference format.
Agent
Config quality reviewer. Scope: agents/skills/rules (.md) — verbosity, duplication, cross-refs, roster overlap; applies fixes. NOT for hooks (foundry:sw-engineer), ADRs (foundry:solution-architect), adversarial challenge (foundry:challenger). TRIGGER: "audit this agent", "review .claude/agents/X". SKIP: general code…
Agent
Docs specialist — docstrings, API refs, README, standalone FAQ/comparison tables. NOT for CHANGELOG (oss:shepherd), linting (foundry:linting-expert), implementation (foundry:sw-engineer), narrative content (foundry:creator). TRIGGER: "write docs for", "add docstrings to", "update the README". SKIP: one-sentence doc…
Agent
Python static analysis — ruff, mypy, pre-commit, lint/type fixes, type annotations. NOT for CI topology (oss:cicd-steward), test logic (foundry:qa-specialist), non-style implementation (foundry:sw-engineer), docstrings (foundry:doc-scribe). TRIGGER: "is this clean", "lint issues", "check types", "add type hints".…
Agent
Perf engineer — CPU/GPU/memory/I/O bottlenecks, DataLoader throughput, PyTorch tuning. Profile-first, measures before changing. NOT for refactoring (foundry:sw-engineer), architecture (foundry:solution-architect), DataLoader correctness (research:data-steward). TRIGGER: "why is this slow", "profile this", "optimize…
Agent
QA specialist writing/fixing tests. Black-box tester: public API surface, expectations from docs not implementation. NOT for linting (foundry:linting-expert), implementation (foundry:sw-engineer), test perf (foundry:perf-optimizer), non-Python frameworks. TRIGGER: "write tests for", "add unit tests". SKIP: read-only…
Agent
Architectural spec specialist — ADRs, API design, migration plans, component diagrams. Reads code, produces specs only. NOT for implementation (foundry:sw-engineer), release mgmt (oss:shepherd), adversarial challenge (foundry:challenger), perf tuning (foundry:perf-optimizer). TRIGGER: "how should I structure this"…
Agent
Senior SW engineer writing/refactoring Python — features, bugfixes, TDD, SOLID. Also authors hook JS files under hooks/. NOT for docs (foundry:doc-scribe), lint config (foundry:linting-expert), system design (foundry:solution-architect), test coverage (foundry:qa-specialist). TRIGGER: "implement", "build", "fix this…
Agent
Fetches web pages, API docs, external package/release info — version lookups, GitHub release extraction, docs scraping. NOT for code analysis (foundry:sw-engineer), ML paper analysis (research:scientist), internal docs (foundry:doc-scribe), local codebase search. TRIGGER: "check the README of for", "look up", "latest…
Agent
CI/CD health specialist, Python/GitHub Actions only — failing CI runs, build times, test matrices, caching, SHA pinning. NOT for ruff/mypy config (foundry:linting-expert), PyPI release/CHANGELOG (oss:shepherd), non-GitHub-Actions platforms. TRIGGER: failing CI runs, slow builds, caching/SHA-pinning questions. SKIP: no…
Agent
Fetches all GitHub API data for a repo (REST + GraphQL) in two parallel groups; writes raw JSONL for oss:repo-warden axis scorers. TRIGGER when: spawned by /oss:analyse (vitality mode) to fetch raw GitHub data. NOT for axis scoring or report generation. NOT for direct user invocation.
Agent
Scores an assigned group of vitality axes from a pre-fetched DATAFILE using vitality-scoring.md; writes partial scores JSON for /oss:analyse assembly. TRIGGER when: spawned 3× in parallel by /oss:analyse (vitality mode) to score axis groups A, B, or C. NOT for raw data fetching (oss:gh-scraper), NOT for report…
Agent
OSS shepherd, Python/ML/CV/AI — contributor communication (triage, reply/PR drafts), release coordination (SemVer, PyPI, CHANGELOG). NOT for docstrings/README (foundry:doc-scribe), CI/publish YAML (oss:cicd-steward), diff review (/oss:review), CHANGELOG gen (/oss:release). TRIGGER: triaging issues/PRs, SemVer. SKIP…
Agent
Data lifecycle specialist — dataset acquisition, DVC versioning, split audits, leakage detection, DataLoader config. Manual invocation only — no research skill auto-dispatches this agent. Delegates scraping to foundry:web-explorer. NOT for ML experiment design (research:scientist), DataLoader throughput…
Agent
AI/ML researcher — paper analysis, hypothesis generation, experiment design. ONLY for named research paper/hypothesis/experiment. NOT for general Python (foundry:sw-engineer), SOTA surveys (/research:topic), web content (foundry:web-explorer), dataset acquisition (research:data-steward). TRIGGER: implementing from…