---
name: x-cmd/scan
source: https://app.decimal.ai/s/x-cmd-scan@1/SKILL.md
source_sha256: f9ecf7d046ba
---

# Quick Scanner

## Trigger

Use when:
- User says `/scan`
- User wants a quick health check
- Time-constrained review needed

Do NOT use when:
- User wants exhaustive check (use `/check`)
- User wants full assessment (use `/assess`)

## Steps

### Step 1: Parse Arguments

```
/scan [--ruleset <dir>] [target_root]
```

Default: current directory.

### Step 2: Load Rules

```bash
x rule which
ls $ruleset_dir/*.yml
cat $ruleset_dir/*.yml
```

### Step 3: Greedy Scan

Strategy:
- Do NOT check every file against every rule
- Find the 1-5 most obvious, most severe violations
- Trust first instinct
- Speed over completeness
- Stop early when 1-5 critical issues found

### Step 4: Output Results

## Output Format

TSV with header:
```
root    target    ruleid    score    hint
```

If nothing obviously wrong: output header row only.

## Constraints

- Maximum 5 issues reported
- Stop after finding 5 or when no obvious issues remain
- Do NOT do exhaustive analysis