# Project Detection

> Framework and stack identification with detection scripts and patterns. Use when detecting project type, analyzing framework, identifying stack, initializing projects, or when user mentions project detection, framework analysis, stack identification, or codebase analysis.

- Skill: `majiayu000/project-detection` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/project-detection`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/project-detection/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/project-detection

---


# Project Detection

**CRITICAL: The description field above controls when Claude auto-loads this skill.**

This skill provides mechanical detection scripts and patterns for identifying project frameworks, languages, and structures across any technology stack.

## What This Skill Provides

### 1. Detection Scripts (Mechanical - No AI Needed)
- `detect-framework.sh` - Identifies framework from config files
- `detect-language.sh` - Detects primary programming language
- `detect-structure.sh` - Maps project directory structure
- `detect-tools.sh` - Finds build tools, linters, formatters
- `analyze-dependencies.sh` - Analyzes package dependencies

### 2. Templates
- `project-json.template` - Standard project.json structure
- Framework detection patterns for 20+ frameworks
- Language detection rules

### 3. Reference Documentation
- Framework identification rules
- Directory structure patterns
- Tooling detection logic

## Instructions

When user asks to detect or analyze a project:

### Step 1: Run Framework Detection

Execute the framework detection script:

!{bash plugins/01-core/skills/project-detection/scripts/detect-framework.sh .}

This mechanically checks for:
- package.json (Node.js/JavaScript)
- pyproject.toml, requirements.txt (Python)
- Cargo.toml (Rust)
- go.mod (Go)
- pom.xml, build.gradle (Java)
- composer.json (PHP)
- Gemfile (Ruby)

### Step 2: Detect Language and Version

Execute language detection:

!{bash plugins/01-core/skills/project-detection/scripts/detect-language.sh .}

### Step 3: Map Directory Structure

Execute structure detection:

!{bash plugins/01-core/skills/project-detection/scripts/detect-structure.sh .}

### Step 4: Analyze Dependencies and Tools

Execute dependency analysis:

!{bash plugins/01-core/skills/project-detection/scripts/analyze-dependencies.sh .}

### Step 5: Generate Project Configuration

Use the detected information to create .claude/project.json with:
- type (web-app, api, cli, library, etc.)
- framework (Next.js, Django, FastAPI, etc.)
- language and version
- structure mappings
- tools (build, test, lint, format)
- dependencies

## Detection Patterns

### Framework Detection Rules

**Node.js Frameworks:**
- Next.js: package.json contains "next" dependency + pages/ or app/ directory
- React: package.json contains "react" + src/components/
- Vue: package.json contains "vue" + src/
- Express: package.json contains "express"
- NestJS: package.json contains "@nestjs/core"

**Python Frameworks:**
- Django: requirements.txt contains "Django" or pyproject.toml lists django
- FastAPI: fastapi dependency + app/main.py pattern
- Flask: flask dependency
- Streamlit: streamlit dependency

**Rust:**
- Cargo.toml [package] section
- Check for web frameworks: axum, actix-web, rocket

**Go:**
- go.mod file
- Check for frameworks: gin, echo, fiber

### Structure Detection Patterns

**Common Patterns:**
- src/, app/, lib/ → Source code
- components/, pages/ → Frontend
- api/, routes/, handlers/ → Backend
- tests/, test/, spec/ → Tests
- docs/, documentation/ → Documentation
- config/, .config/ → Configuration

## Examples

**Example 1: Detect Next.js Project**

User: "What framework is this project using?"

Claude (auto-loads this skill, runs detection):
!{bash plugins/01-core/skills/project-detection/scripts/detect-framework.sh .}

Result: "Next.js 14.0.0 with TypeScript, App Router architecture"

**Example 2: Initialize New Project**

User: "Initialize this project"

Claude (auto-loads this skill, analyzes structure):
!{bash plugins/01-core/skills/project-detection/scripts/detect-structure.sh .}

Creates .claude/project.json with detected mappings

## Requirements

**Scripts must be:**
- ✅ Mechanical (pattern recognition, no AI decisions)
- ✅ Fast (complete in < 1 second)
- ✅ Project-agnostic (work with ANY framework)
- ✅ Exit codes: 0 = success, 1 = error

**Output format:**
- JSON for machine parsing
- Clear status messages for humans
- Error messages explain what's missing

## Success Criteria

- ✅ Detects 20+ frameworks accurately
- ✅ Works in any project directory
- ✅ Generates valid project.json
- ✅ Scripts are executable and documented
- ✅ No hardcoded assumptions about structure

---

**Plugin**: 01-core
**Skill Type**: Analyzer + Generator
**Auto-invocation**: Yes (via description matching)