rileyhilliard
@rileyhilliard
Public Skills
documenting-code-comments
by rileyhilliard
Standards for self-documenting code and minimal comments. Use when auditing inline documentation or deciding when comments add value vs clutter.
handling-errors
by rileyhilliard
Prevents silent failures and context loss in error handling. Use when writing try-catch blocks, designing error propagation, reviewing catch blocks, or implementing Result patterns.
managing-pipelines
by rileyhilliard
Guides CI/CD pipeline architecture, security hardening, and deployment strategies for GitHub Actions. Use when designing workflows, securing supply chains, optimizing build performance, configuring deployments, managing infrastructure as code pipelines, or setting up pipeline observability.
managing-databases
by rileyhilliard
Guides database architecture decisions for PostgreSQL, DuckDB, Parquet, PGVector, and Neo4j. Use when designing schemas, choosing storage strategies, optimizing queries, tuning maintenance, configuring vector search, modeling graph data, or diagnosing performance issues across OLTP, OLAP, similarity search, and graph workloads.
writing-plans
by rileyhilliard
Create implementation plans with tasks grouped by subsystem. Related tasks share agent context; groups parallelize across subsystems.
verification-before-completion
by rileyhilliard
Run verification commands before claiming work is complete or fixed. Use before asserting any task is done, bug is fixed, tests pass, or feature works.
post-mortem
by rileyhilliard
Review a completed session to extract actionable improvements. Identifies DX friction, documentation gaps, architectural confusion, anti-patterns, process failures, and skill/config improvements. Uses progressive disclosure for targeted investigation types.
executing-plans
by rileyhilliard
Executes implementation plans with smart task grouping. Groups related tasks to share context, parallelizes across independent subsystems.
preflight-checks
by rileyhilliard
Detect and run project linters, formatters, and type checkers before committing or claiming completion. Auto-detects tools from project config files.
architecting-systems
by rileyhilliard
Guides clean, scalable system architecture during the build phase. Use when designing modules, defining boundaries, structuring projects, managing dependencies, or preventing tight coupling and brittleness as systems grow.
writer
by rileyhilliard
Writing style and tone guide for human-sounding content. Use when writing documentation, READMEs, commit messages, PR descriptions, blog posts, or any user-facing content.
strategy-writer
by rileyhilliard
Produces executive-quality strategic documents in The Economist/HBR style. Use when writing strategy memos, market analysis, business cases, customer research reports, or any document for Product, Design, and Business leaders. Customer-led, evidence-based, narrative-driven.
documenting-systems
by rileyhilliard
Creates task-oriented technical documentation with progressive disclosure. Use when writing READMEs, API docs, architecture docs, or markdown documentation.
fixing-flaky-tests
by rileyhilliard
Diagnose and fix tests that pass in isolation but fail when run concurrently. Covers shared state isolation and resource conflicts. References condition-based-waiting for timing issues.
condition-based-waiting
by rileyhilliard
Fixes flaky tests by replacing arbitrary timeouts with condition polling. Use when tests fail intermittently, have setTimeout delays, or involve async operations that need proper wait conditions.
writing-tests
by rileyhilliard
Writes behavior-focused tests using Testing Trophy model with real dependencies. Use when writing tests, choosing test types, or avoiding anti-patterns like testing mocks.
reading-logs
by rileyhilliard
Analyzes logs efficiently through targeted search and iterative refinement. Use when investigating errors, debugging incidents, or analyzing patterns in application logs.
optimizing-performance
by rileyhilliard
Measure-first performance optimization that balances gains against complexity. Use when addressing slow code, profiling issues, or evaluating optimization trade-offs.
design
by rileyhilliard
Enforces precise, minimal design for dashboards and admin interfaces. Use when building SaaS UIs, data-heavy interfaces, or any product needing Jony Ive-level craft.
visualizing-with-mermaid
by rileyhilliard
Creates professional Mermaid diagrams with semantic styling and visual hierarchy. Use when creating flowcharts, sequence diagrams, state machines, class diagrams, or architecture visualizations.
refactoring-code
by rileyhilliard
Improves code structure while preserving behavior through test verification. Use when cleaning up code, reducing duplication, simplifying complexity, or reorganizing modules.
systematic-debugging
by rileyhilliard
Four-phase debugging framework that finds root causes before proposing fixes. Use when investigating bugs, errors, unexpected behavior, failed tests, or when previous fixes haven't worked.