scan-stylistic

Scan TypeScript/React/Hono codebases for stylistic refactoring opportunities and generate a prioritized backlog.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/sncollective/snc-platform --skill scan-stylistic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scan-stylistic
Source: https://github.com/sncollective/snc-platform/tree/main/.claude/skills/scan-stylistic
Command: npx skills add https://github.com/sncollective/snc-platform --skill scan-stylistic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill tackles inconsistent coding styles in TypeScript/React/Hono codebases that hinder readability, maintainability, and team collaboration by identifying and prioritizing refactoring opportunities.

Core Features & Use Cases

  • Style Scanning: Checks for adherence to six key rules like early returns, readonly boundaries, and exhaustive unions, using references for rationale and examples.
  • Prioritized Backlog: Generates a tiered output (High Value, Worth Considering, Not Worth It) with file paths, current vs. target code, and acceptance criteria.
  • Use Case: For a platform like snc-platform, scan routes and components to flag nested if/else blocks, suggesting guard clauses to streamline error handling in API middleware.

Quick Start

Activate the scan-stylistic skill to analyze the snc-platform repository for stylistic improvements and output a refactoring backlog to docs/scan-stylistic-backlog.md.

Frequently Asked Questions about scan-stylistic

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find refactoring opportunities for inconsistent TypeScript code styles?

To find refactoring opportunities for inconsistent TypeScript code styles, scan your codebase against team preferences like early returns and readonly boundaries. This process analyzes your repository to flag stylistic inconsistencies and generates a prioritized backlog of high-value changes.

What are common stylistic refactoring rules for React and Hono codebases?

Common stylistic refactoring rules for React and Hono codebases include using early returns, enforcing readonly boundaries, and ensuring exhaustive unions. Applying these rules improves readability and maintainability across API routes and UI components.

Can I scan specific directories like apps/api/src and apps/web/src for code style issues?

Yes, you can scan specific directories like apps/api/src and apps/web/src for code style issues. The scanning process applies repository-wide analysis to these paths and shared packages to identify targeted refactoring tasks based on your team's defined preferences.

How do I prioritize a TypeScript refactoring backlog?

You prioritize a TypeScript refactoring backlog by categorizing identified issues into high value, worth considering, and not worth it tiers. This approach outputs a document with file paths, current versus target code examples, and acceptance criteria to guide safe refactors.

Does code style scanning flag nested if/else blocks in API middleware?

Yes, code style scanning flags nested if/else blocks in API middleware. It scans routes and components to identify these patterns and suggests guard clauses to streamline error handling and improve overall code readability.