dimitrigilbert/task-o-matic

Overview

This skill is an expert code review agent for TypeScript projects that validates implementations against task requirements and product specs. It catches security holes, crashes, logic bugs, and style issues, then produces actionable fix tasks. The skill focuses on outcomes: safe builds, satisfied acceptance criteria, and clear remediation steps.

How this skill works

The agent reads the task description and any linked PRD, inspects diffs or commits for changes, and runs a checklist across requirements, critical failures, major logic problems, and minor style issues. For each Critical or Major problem it constructs a precise Fix Subtask with step-by-step instructions and estimated effort. Finally it emits a structured review summary that lists blocking fixes, recommended improvements, and verified items.

When to use it

• Before merging a feature branch or PR to ensure requirements are met
• When a task links to a PRD and acceptance criteria must be verified
• After automated tests pass but before release to catch logic/security regressions
• When onboarding new contributors to enforce project patterns and prevent rework

Best practices

• Always start by loading the Task description and any PRD to ground the review in requirements
• Run diffs against the base branch and focus first on Critical issues that break builds or cause data loss
• For each blocking issue create a small, actionable fix subtask with detailed reproduction steps and code pointers
• Distinguish Major (functional) from Minor (style) problems and let linting handle most stylistic items
• Keep review comments concise and solution-oriented: link to specific lines, suggest code snippets, and cite tests to add

Example use cases

• A new payment integration branch should be reviewed for security, transaction rollback, and acceptance criteria compliance
• A refactor that touches core utilities needs logic and performance validation to prevent regressions
• Pull requests that touch authentication, encryption, or data persistence should be scanned for critical issues
• Feature tasks with linked PRDs require mapping each acceptance criterion to verified code paths