One-click install
npx skills add https://github.com/codybrom/clairvoyance --skill red-flags-codybrom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: red-flags
Source: https://github.com/codybrom/clairvoyance/tree/main/skills/red-flags
Command: npx skills add https://github.com/codybrom/clairvoyance --skill red-flags-codybrom

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps identify software design problems that make code difficult to understand, change, or maintain before they become larger architectural issues.

Core Features & Use Cases

  • Comprehensive Design Scan: Evaluate code against 17 structural, boundary, documentation, naming, abstraction, and process-related design smells.
  • Actionable Diagnostics: Classify each flag as CLEAR, TRIGGERED, or N/A, then connect findings to specific design principles and recommended fixes.
  • Architectural Pattern Recognition: Detect related red flags as syndrome clusters, such as shallow wrapper stacks, leaky abstractions, and error avalanches.
  • Use Case: Apply the Skill to a pull request, unfamiliar module, or directory to reveal hidden coupling, excessive interface complexity, vague abstractions, and tactical shortcuts.

Quick Start

Ask the red-flags skill to scan the specified file or directory and produce a prioritized diagnostic report with locations, violated principles, and recommended fixes.

Frequently Asked Questions about red-flags

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

FAQPage Schema
How do I identify design smells in a codebase before they become technical debt?

To identify design smells before they become technical debt, scan code against 17 structural, boundary, and abstraction red flags. This diagnostic process classifies findings as CLEAR or TRIGGERED and maps related issues to architectural syndromes like shallow wrappers or leaky abstractions.

What is the best way to review a pull request for software architecture issues?

The best way to review a pull request for software architecture issues is to evaluate changes against a checklist of 17 design smells. This reveals hidden coupling, vague abstractions, and tactical shortcuts, providing prioritized corrective actions.

How does detecting related red flags help diagnose leaky abstractions?

Detecting related red flags helps diagnose leaky abstractions by clustering individual findings into architectural syndromes. This pattern recognition connects isolated design smells, revealing broader structural issues like error avalanches or shallow wrapper stacks.

Can I use an automated checklist to assess unfamiliar modules for hidden coupling?

Yes, you can assess unfamiliar modules for hidden coupling by applying a comprehensive design scan. This evaluates code against 17 structural and boundary red flags, classifying each as CLEAR, TRIGGERED, or N/A to expose excessive interface complexity.

What should I do when a module assessment reveals error handling design smells?

When a module assessment reveals error handling design smells, use the diagnostic report to map findings to specific design principles. This provides prioritized corrective actions to resolve detected architectural syndromes.