hyhmrright/logic-lens

logic-health

Sweep a directory, module, or full codebase for logic correctness and produce a scored health dashboard with systemic patterns. Trigger when the user requests a health view — "audit the whole codebase", "health check", "health overview", "logic health overview", "audit src/", "audit auth and payments modules", "where should I focus testing", "onboarding review", "logic overview before we ship", "give me a health overview of this module". SCOPE RULE: prefer multi-file; also trigger for a single …

First seen May 12, 2026

Installation

$ npx skills add hyhmrright/logic-lens --skill logic-health

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from hyhmrright/logic-lens.

npx skills add hyhmrright/logic-lens

Browse all from hyhmrright/logic-lens

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 22
License LICENSE
Default branch main
Open issues 5
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,069 B
  • docs SUMMARY.md 855 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 12 installs

SKILL.md

Logic-Lens — Logic Health

Setup

Use lazy loading per ../_shared/common.md §13:

  1. Read ../_shared/common.md only for language, Iron Law, Logic Score, scope routing, Remedy discipline, config fields, and loading budget.
  2. Read only the relevant step in logic-health-guide.md as you reach it.
  3. Load ../shared/logic-risks.md, ../shared/semiformal-guide.md, ../shared/semiformal-checklist.md, ../shared/report-template.md, and ../logic-review/logic-review-guide.md on demand when the current module trace needs them.

Process

Step 0. Language + scope routing. Detect language per common.md §1. Proceed for multi-file scopes and for single-module scopes when the user explicitly uses "health check", "health overview", or "logic health". If scope is one file and none of those health phrases appear, switch to logic-review.

Step 1. Enumerate modules and plan the sweep (guide Step 1) — prioritize public API surfaces, recently changed files, and user-flagged modules. Read .logic-lens.yaml only for ignore:, focus:, disable:, severity:, custom_risks, and trace.* fields. For broad scopes, build a ranked worklist before opening files.

Step 2. Run focused logic-review per module (guide Step 2) — apply Premises → Trace → Divergence on public-facing functions; skip internal helpers unless a trace leads into them. Apply the per-module function budget from guide Step 2 (small/medium/large line-count tiers) — do not trace all functions in large modules.

Step 3. Record findings per module (guide Step 3) — tag module, L-code, severity.

Step 4. Aggregate findings (guide Step 4) — counts by severity and by L-code; cross-reference modules.

Step 5. Compute scores (guide Step 5) — per-module Logic Score via the standard formula; overall score is the line-weighted average (per common.md §6).

Step 6. Identify systemic patterns (guide Step 6) — L-codes appearing in ≥ 3 modules or ≥ 30% of scanned modules (whichever threshold is lower) indicate codebase-wide habits; architectural enablers (heavy global state → L7; deep callee chains → L6) get explicit mention.

Step 7. Output the Health Report (guide Step 7) — standard header; Findings; Summary; then Module Breakdown, Systemic Patterns, and Recommended Priority Order (top 3–5) appended after Summary. Localize all headers if the user wrote in Chinese.

Mode line in report: Logic Health (Chinese: 逻辑体检).

Health-specific additions (append after the standard Summary):

## Module Breakdown

| Module | Score | Critical | Warning | Suggestion | Top Risk |
|--------|-------|----------|---------|------------|----------|

## Systemic Patterns
[Risk codes appearing in ≥ 3 modules or ≥ 30% of scanned modules — codebase-wide habit rather than isolated bugs]

## Recommended Priority Order
1. [Most critical single finding]
2. [Systemic pattern with widest impact]
3. [Quick wins: suggestions that prevent future Criticals]

Localize column and section headers when the user wrote in Chinese (e.g., 模块分布, 系统性模式, 优先级建议).