project-analyzer - SKILL.md Agent Skill

name: project-analyzer description: | Deep analysis of project codebases - LOC, dependencies, architecture, git history. Generates comprehensive project profiles for documentation and portfolio.

Triggers: "analyze project", "project stats", "codebase analysis", "/analyze" version: 1.0.0 author: Claude Code allowed-tools: - Bash(git:) - Bash(tokei:) - Bash(cloc:) - Bash(tree:) - Read - Glob - Grep

Project Analyzer

Deep analysis of project codebases for documentation and portfolio generation.

Capabilities

Code Statistics

Lines of code by language
File count and distribution
Comment density
Code complexity metrics

Dependency Analysis

Direct dependencies
Dev dependencies
Outdated packages
Security vulnerabilities

Git Analytics

Total commits
Contributors
Activity timeline
Commit frequency patterns

Architecture Detection

Framework identification
Design patterns used
Module structure
API surface

Usage

# Analyze current project
/analyze

# Analyze specific project
/analyze --project ~/projects/my-app

# Generate full report
/analyze --full --output report.md

Output Format

project:
  name: my-project
  path: /path/to/project
  created: 2025-10-15
  last_activity: 2026-01-19
  
code:
  total_lines: 45230
  languages:
    Python: 28450
    TypeScript: 12340
    YAML: 2100
    Markdown: 2340
  files: 234
  
git:
  total_commits: 847
  contributors: 3
  first_commit: 2025-10-15
  last_commit: 2026-01-19
  commit_frequency: 12/week
  
stack:
  frameworks: [FastAPI, Next.js, LangChain]
  databases: [PostgreSQL, Qdrant]
  infrastructure: [Docker, Vercel]
  
health:
  test_coverage: 78%
  doc_coverage: 65%
  dependency_freshness: 89%

Integration

Feeds into:

knowledge-forge for Obsidian notes
portfolio-forge for static site generation

Requirements

Install analysis tools:

# Code statistics (choose one)
brew install tokei  # Fast, Rust-based
brew install cloc   # Comprehensive, Perl-based

# For tree visualization
brew install tree