stack-review

Audits code for Outfitter Stack compliance including Result types, error handling, logging patterns, and path safety. Use for pre-commit reviews, code quality checks, migration validation, or when "audit", "check compliance", "review stack", or "stack patterns" are mentioned.

Jump to install

Repository: outfitter-dev/agents
Last source activity: January 27, 2026 at 20:29
Detected SKILL.md language: English
Stars: 28
Forks: 1

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/outfitter-dev/agents --skill stack-review

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

gitbutler-complete-branch

This skill should be used when the user asks to "complete a branch", "merge to main", "finish my feature", "ship this branch", "integrate to main", "create a PR from GitButler", or when `--complete-branch` flag is mentioned. Guides completion of GitButler virtual branches with safety snapshots, integration workflows, and cleanup.

2026-02-06

gitbutler-multi-agent

This skill should be used when coordinating multiple AI agents working concurrently, handling agent handoffs, transferring commits between agents, or when "multi-agent", "concurrent agents", "parallel agents", "agent collaboration", or "parallel execution" are mentioned with GitButler. Provides virtual branch patterns for parallel execution without coordination overhead.

2026-02-06

gitbutler-stacks

This skill should be used when creating stacks, dependent branches, or when "stack", "stacked branches", "anchor", "--anchor", "but branch new -a", "create dependent branch", or "break feature into PRs" are mentioned with GitButler. Covers anchor-based stacking for dependent features and reviewable PR breakdown.

2026-02-06

View all from this repository

# Find handlers
rg "Handler<" --type ts -A 2

# Find missing context
rg "Handler<.*> = async \(input\)" --type ts

# Critical issues (count)
rg "throw new|catch \(" --type ts -c

# Console usage (count)
rg "console\.(log|error|warn)" --type ts -c

# Handler patterns
rg "Handler<" --type ts -A 2

// BAD: Throwing
if (!user) throw new Error("Not found");

// GOOD: Result.err
if (!user) return Result.err(new NotFoundError("user", id));

// BAD: try/catch for control flow
try { await handler(input, ctx); } catch (e) { ... }

// GOOD: Result checking
const result = await handler(input, ctx);
if (result.isErr()) { ... }

// BAD
console.log("User " + user.name);
logger.info("Config: " + JSON.stringify(config));

// GOOD
ctx.logger.info("Processing", { userId: user.id });
ctx.logger.debug("Config loaded", { config });  // redaction enabled

// BAD
const configPath = path.join(os.homedir(), ".myapp", "config.json");
const userFile = path.join(baseDir, userInput);  // traversal risk!

// GOOD
const configDir = getConfigDir("myapp");
const result = securePath(userInput, workspaceRoot);
await atomicWriteJson(configPath, data);

# Find thrown exceptions
rg "throw new" --type ts

# Find console usage
rg "console\.(log|error|warn)" --type ts

# Find hardcoded paths
rg "(homedir|~\/\.)" --type ts

# Find custom errors
rg "class \w+Error extends Error" --type ts

# Find handlers without context
rg "Handler<.*> = async \(input\)" --type ts

Level	Examples
Critical	Thrown exceptions, unvalidated paths, missing error handling
High	Console logging, hardcoded paths, missing context
Medium	Missing type annotations, non-atomic writes
Low	Style issues, missing documentation

## Stack Compliance: [file/module]

**Status**: PASS | WARNINGS | FAIL
**Issues**: X critical, Y high, Z medium

### Critical
1. [file:line] Issue description

### High
1. [file:line] Issue description

### Recommendations
- Recommendation with fix

Category	Use For
`validation`	Invalid input, schema failures
`not_found`	Resource doesn't exist
`conflict`	Already exists, version mismatch
`permission`	Forbidden action
`internal`	Unexpected errors, bugs

stack-review

Install options

Review the source files

Stack Compliance Review

6-Step Audit Process

Step 1: Scan for Anti-Patterns

Stack Compliance Review

6-Step Audit Process

Step 1: Scan for Anti-Patterns

Step 2: Review Handler Signatures

Step 3: Check Error Usage

Step 4: Validate Logging

Step 5: Check Path Safety

Step 6: Review Context

Quick Audit

Checklist

Result Types

Error Taxonomy

Logging

Path Safety

Context Propagation

Validation

Output

Audit Commands

Severity Levels

Report Format

Related Skills

name	stack-review
version	0.1.0
description	Audits code for Outfitter Stack compliance including Result types, error handling, logging patterns, and path safety. Use for pre-commit reviews, code quality checks, migration validation, or when "audit", "check compliance", "review stack", or "stack patterns" are mentioned.
context	fork
agent	stacker
allowed-tools	Read Grep Glob Bash(rg *)

stack-review

Source facts

Install options

Review the source files

More from this repository

More from this repository

Stack Compliance Review

6-Step Audit Process

Step 1: Scan for Anti-Patterns

Stack Compliance Review

6-Step Audit Process

Step 1: Scan for Anti-Patterns

Step 2: Review Handler Signatures

Step 3: Check Error Usage

Step 4: Validate Logging

Step 5: Check Path Safety

Step 6: Review Context

Quick Audit

Checklist

Result Types

Error Taxonomy

Logging

Path Safety

Context Propagation

Validation

Output

Audit Commands

Severity Levels

Report Format

Related Skills