How do I install the Project Scanner skill?

Run npx skillmds@latest add khaihuynhvn/project-scanner in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Project Scanner safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Project Scanner?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Project Scanner free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Project Scanner?

khaihuynhvn (@khaihuynhvn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Project Scanner by khaihuynhvn — Agent Skill

Name: Project Scanner
Author: khaihuynhvn

File contents

Project Scanner Workflow

Scanner Location

C:\Users\BLogic\.cursor\user-scripts\project-scanner\

Commands

# Full scan
npx tsx scan.ts --path "<project-src-path>" --framework angular

# Query specific
npx tsx scan.ts --path "<project-src-path>" --framework angular --query "ClassName"

Output Files

File	When
`output.json`	Full scan
`output-query.json`	Query mode

When to Scan

Situation	Action
First time với project	Full scan
Edit shared service/utility	Query class
Change method signature	Query class → check calledBy
Delete/rename	Query → check all references
Create new code	Query similar existing

When NOT to Scan

Simple typo fix
Private method internal change
New isolated code (0 callers)
Already have context
Comment/doc updates

Quality Gates (MANDATORY)

Trigger	MUST Check
Change method signature	`calledBy`
Class extends another	`inheritance`
Shared service	`summary.mostUsedServices`
Delete/rename	All references

Reading Output (Token-Efficient)

Full scan → Read ONLY summary section first
Query → Read calledBy + inheritance

Key sections:

calledBy: Ai gọi method này
callChain: Multi-level call path
inheritance: Parent/child classes
deadCode: Unused methods
summary.mostUsedServices: High-impact services

Pattern-First Principle

Before CREATE → Query similar existing code
Before EDIT → Check existing patterns
Follow 100% existing style

Example Workflow

User: "Sửa SalonService.list()"

1. Query SalonService
2. Read calledBy → Biết SalonsComponent gọi
3. Check signature → Không đổi thì OK
4. Edit safely

Integration

Scanner được reference từ:

angular-coding/SKILL.md → Pre-edit analysis

---name: project-scannerdescription: Codebase analysis tool for quality-first editing. Scan before edit to understand relationships, patterns, and impact.---# Project Scanner Workflow## Scanner Location```C:\Users\BLogic\.cursor\user-scripts\project-scanner\```## Commands```bash# Full scannpx tsx scan.ts --path "<project-src-path>" --framework angular# Query specificnpx tsx scan.ts --path "<project-src-path>" --framework angular --query "ClassName"```## Output Files| File | When ||------|------|| `output.json` | Full scan || `output-query.json` | Query mode |## When to Scan| Situation | Action ||-----------|--------|| First time với project | Full scan || Edit shared service/utility | Query class || Change method signature | Query class → check calledBy || Delete/rename | Query → check all references || Create new code | Query similar existing |## When NOT to Scan- Simple typo fix- Private method internal change- New isolated code (0 callers)- Already have context- Comment/doc updates## Quality Gates (MANDATORY)| Trigger | MUST Check ||---------|------------|| Change method signature | `calledBy` || Class extends another | `inheritance` || Shared service | `summary.mostUsedServices` || Delete/rename | All references |## Reading Output (Token-Efficient)```Full scan → Read ONLY summary section firstQuery → Read calledBy + inheritance```**Key sections:**- `calledBy`: Ai gọi method này- `callChain`: Multi-level call path- `inheritance`: Parent/child classes- `deadCode`: Unused methods- `summary.mostUsedServices`: High-impact services## Pattern-First Principle```Before CREATE → Query similar existing codeBefore EDIT → Check existing patternsFollow 100% existing style```## Example Workflow```User: "Sửa SalonService.list()"1. Query SalonService2. Read calledBy → Biết SalonsComponent gọi3. Check signature → Không đổi thì OK4. Edit safely```## IntegrationScanner được reference từ:- `angular-coding/SKILL.md` → Pre-edit analysis

Frequently asked questions

Project Scanner