Datastoria source-code-inspection

Investigate application or repository source code with search_file and read_file to explain behavior, trace root causes of runtime or query errors, and answer with precise file citations.

install

source · Clone the upstream repo

git clone https://github.com/FrankChen021/datastoria

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/FrankChen021/datastoria "$T" && mkdir -p ~/.claude/skills && cp -r "$T/resources/skills/source-code-inspection" ~/.claude/skills/frankchen021-datastoria-source-code-inspection && rm -rf "$T"

manifest: resources/skills/source-code-inspection/SKILL.md

source content

When To Use

Use this skill when the user wants to:

investigate source-code causes of runtime failures or query errors
trace where SQL, configuration, or request parameters were built in code
find the code path that led to an error such as
```
UNKNOWN_TABLE
```
explain behavior with file-cited evidence from the repository

Workflow

Use
```
search_file
```
first to locate relevant files and line numbers before reading content.
Use
```
read_file
```
only for targeted sections; do not read entire files or large ranges.
Prefer narrow, iterative reads: search identifiers, function names, or error strings, then expand only when necessary.
Do not claim to have reviewed code that was not loaded with tools in this conversation.
If
```
no matches found
```
, refine the search and retry before giving up.

Citation Format

Always use this exact format for source-file citations:

```
[[file:path/to/file.ts]]
```
```
[[file:path/to/file.ts#L12]]
```
```
[[file:path/to/file.ts#L12-L34]]
```

Use repo-relative paths and line anchors whenever possible. Do not use normal markdown links for source-code citations. Do not wrap file citation tokens in backticks, inline code, or fenced code blocks in your final answer. Use them as plain citation tokens in normal prose or list items so the UI can render them as clickable links.

Response Style

Keep answers concise and evidence-based.
Tie each claim to one or more file citations.
If the code path is unclear or partially inspected, say so explicitly.