What is the 'beads' integration mentioned in the skill?

Beads are persistent issue tracking objects. This skill uses them to remember previous findings, ensuring that it doesn't re-flag issues that have already been acknowledged or intentionally resolved as a fix.

How does this differ from a standard linter like ESLint?

Standard linters catch syntax, style, and simple complexity issues. This skill focuses on higher-level design problems like improper abstraction, violations of the Single Responsibility Principle, and architectural barriers to testing.

Which programming languages does the review-code skill support?

The skill is language-agnostic because it focuses on universal software design principles such as naming clarity, error handling strategies, and dependency management.

Can this skill suggest actual code changes?

Yes, it provides concrete prescriptions for every P1 and P2 issue found, including specific API signatures and 'done when' criteria to verify the fix.

Advanced Architectural Reviewer

Name: Advanced Architectural Reviewer
Author: lumberbarons

bylumberbarons

0•

Collaboration Tools

Analyzes source code for design, architecture, and maintainability issues that standard static analysis and linters miss.

This skill empowers Claude to perform deep architectural audits by evaluating code against core design principles like Single Responsibility, Abstraction Levels, and Testability. Unlike traditional linters that focus on syntax or formatting, this skill identifies logical design flaws, leaky abstractions, and naming inconsistencies. It integrates seamlessly with the Specbeads system to track findings, deduplicate issues, and provide concrete, verifiable prescriptions for improving code quality and long-term maintainability.

Key Features

01Integrates with 'beads' for automated issue tracking and deduplication

02Identifies Single Responsibility Principle (SRP) violations in functions and modules

030 GitHub stars

04Analyzes abstraction levels to ensure business logic is separated from implementation details

05Checks for meaningful naming and intent-revealing API design

06Evaluates code testability and flags architectural blockers to unit testing

Use Cases

01Identifying technical debt and design inconsistencies in legacy codebases

02Enforcing high-level clean code standards across distributed engineering teams

03Conducting architectural audits on complex pull requests before merging

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lumberbarons/lumber-mart review-code

For use in Claude.ai and ChatGPT

Download Skill