HubLensAI Agentsmattpocock/skills
344

// summary

This collection provides modular, composable agent skills designed to improve software engineering workflows and reduce common AI coding failures. The tools focus on core principles like alignment, shared domain language, and rigorous feedback loops to prevent codebase entropy. These skills are easily installed and adaptable, allowing developers to integrate professional engineering practices directly into their coding agents.

// technical analysis

This project provides a collection of modular, composable skills designed to enhance the performance and reliability of AI coding agents by grounding them in established software engineering fundamentals. It addresses common agent failure modes—such as misalignment, excessive verbosity, and poor code quality—by enforcing structured workflows like domain-driven design, test-driven development, and rigorous diagnostic loops. The design philosophy prioritizes developer control and adaptability, favoring small, specialized tools over monolithic processes that can obscure the development lifecycle.

// key highlights

01
Implements a 'grilling' mechanism that forces agents to interview users to ensure alignment before starting tasks.
02
Utilizes a shared language approach via CONTEXT.md files to reduce agent verbosity and improve domain-specific communication.
03
Provides a TDD skill that enforces a red-green-refactor loop to ensure code quality through automated feedback.
04
Includes an architecture improvement skill that helps identify and refactor 'ball of mud' codebases based on domain documentation.
05
Offers a diagnostic loop skill that standardizes the process of reproducing, minimizing, and fixing bugs.
06
Features a 'caveman' mode that significantly reduces token usage by compressing communication while maintaining technical accuracy.

// use cases

01
Aligning agent output with project goals through detailed grilling sessions
02
Implementing test-driven development and disciplined debugging loops
03
Improving codebase architecture and maintaining domain-specific documentation

// getting started

To begin, install the skills using the command 'npx skills@latest add mattpocock/skills'. Once installed, run the '/setup-matt-pocock-skills' command within your chosen coding agent to configure your issue tracker, triage labels, and documentation preferences. You can then start utilizing specific skills like '/grill-me' or '/tdd' to manage your development workflow.