help.md
View on GitHub
## NAME
`ase-code-insight` - Project Insight
## SYNOPSIS
`ase-code-insight`
[`--help`|`-h`]
*code-references*
## DESCRIPTION
The `ase-code-insight` skill gives high-level *insights* into the
project through the referenced source code. The skill produces four
sections: a *PROJECT ABSTRACT* (summary derived from `README.*` or
source scanning), a *PROJECT AUTHOR* list (from `git shortlog`),
a *SOURCE CHURN* table (most-committed files in the last year), and
a *MODULE STRUCTURE* Mermaid diagram of modules and their imports.
For a project with `black` boxing, the insight gathering is suppressed
entirely.
## ARGUMENTS
- *code-references*:
One or more file or directory references to source code that
should be inspected for insights.
## SCENARIOS
- You want a high-level overview of a project
- You want to know who wrote the project and which files churn most
- You want a module structure diagram of the imports
- You want to get familiar with an unknown code base quickly
## EXAMPLES
Get insights into the current project:
```text
❯ /ase-code-insight src/
```
Get insights into a specific subsystem:
```text
❯ /ase-code-insight tool/src/
```
## SEE ALSO
[`ase-code-explain`](../ase-code-explain/help.md), [`ase-code-analyze`](../ase-code-analyze/help.md), [`ase-arch-analyze`](../ase-arch-analyze/help.md).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |