Skip to content

rse/ase / plugin/skills/ase-code-insight

ase-code-insight

Verified

Give insights into the source code.

FileKindSize
SKILL.mdskill md3.2 KB
help.mdmarkdown1.3 KB

##  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).
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 implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall