# Sq Analysis

> Runs an analysis skill from the squadron analysis pack, such as a tech debt audit or codebase understanding from an understand-anything knowledge graph. Use when the user asks for a codebase audit, architecture review, code quality assessment, or codebase understanding through squadron's analysis pack.

- Skill: `ecorkran/sq-analysis` (Agent Skill)
- Install (CLI): `npx get-skill add ecorkran/sq-analysis`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ecorkran/sq-analysis/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: ecorkran (https://skillmd.com/u/ecorkran)
- Updated: 2026-11-17
- Page: https://skillmd.com/skills/ecorkran/sq-analysis

---


# sq analysis

Run an analysis skill from the squadron analysis pack.

## Input parsing

The first word the user typed after `$sq-analysis` is the skill name. The remainder is passed
through to the skill as its arguments (`[target]` for `tech-debt-audit`, `[flow]` for `understand`).

Valid skills: `tech-debt-audit`, `understand`

If the skill name is missing or unrecognized, show the usage below and stop.

**Usage:**
```
$sq-analysis tech-debt-audit [target]
$sq-analysis understand [flow]
```

---

## Skill: tech-debt-audit

Delegate to the tech-debt-audit skill.

Invoke `$analysis-tech-debt-audit`, passing along any `[target]` the user supplied.

The skill performs a thorough tech debt and architecture audit of the current codebase (or
`[target]` if specified). It produces an audit file with file-cited findings, severity ratings,
effort estimates, and a "looks bad but is actually fine" section.

If the skill is not installed, inform the user:
```
The analysis pack is not installed. Run `sq skills install analysis` to install it.
```

---

## Skill: understand

Delegate to the understand skill.

Invoke `$analysis-understand`, passing along whatever the user typed after the skill name.

The skill reads an existing `understand-anything` knowledge graph of the current codebase and
writes squadron planning documents from it. `[flow]` is optional; the skill's "Flow selection"
section defines the valid flows and rejects any other.

If the skill is not installed, inform the user:
```
The analysis pack is not installed. Run `sq skills install analysis` to install it.
```

