Agent skill

analyzing-projects

Analyzes codebases to understand structure, tech stack, patterns, and conventions. Use when onboarding to a new project, exploring unfamiliar code, or when asked "how does this work?" or "what's the architecture?"

View SKILL.md on GitHub Repository
Stars 1,305
Forks 187

Install this agent skill to your Project

npx add-skill https://github.com/CloudAI-X/claude-workflow-v2/tree/main/skills/analyzing-projects

SKILL.md

Analyzing Projects

When to Load

  • Trigger: Onboarding to a new project, "how does this work" questions, codebase exploration, understanding unfamiliar code
  • Skip: Already familiar with the project structure and patterns

Project Analysis Workflow

Copy this checklist and track progress:

Project Analysis Progress:
- [ ] Step 1: Quick overview (README, root files)
- [ ] Step 2: Detect tech stack
- [ ] Step 3: Map project structure
- [ ] Step 4: Identify key patterns
- [ ] Step 5: Find development workflow
- [ ] Step 6: Generate summary report

Step 1: Quick Overview

bash
# Check for common project markers
ls -la
cat README.md 2>/dev/null | head -50

Step 2: Tech Stack Detection

Package Managers & Dependencies

  • package.json → Node.js/JavaScript/TypeScript
  • requirements.txt / pyproject.toml / setup.py → Python
  • go.mod → Go
  • Cargo.toml → Rust
  • pom.xml / build.gradle → Java
  • Gemfile → Ruby

Frameworks (from dependencies)

  • React, Vue, Angular, Next.js, Nuxt
  • Express, FastAPI, Django, Flask, Rails
  • Spring Boot, Gin, Echo

Infrastructure

  • Dockerfile, docker-compose.yml → Containerized
  • kubernetes/, k8s/ → Kubernetes
  • terraform/, .tf files → IaC
  • serverless.yml → Serverless Framework
  • .github/workflows/ → GitHub Actions

Step 3: Project Structure Analysis

Present as a tree with annotations:

project/
├── src/              # Source code
│   ├── components/   # UI components (React/Vue)
│   ├── services/     # Business logic
│   ├── models/       # Data models
│   └── utils/        # Shared utilities
├── tests/            # Test files
├── docs/             # Documentation
└── config/           # Configuration

Step 4: Key Patterns Identification

Look for and report:

  • Architecture: Monolith, Microservices, Serverless, Monorepo
  • API Style: REST, GraphQL, gRPC, tRPC
  • State Management: Redux, Zustand, MobX, Context
  • Database: SQL, NoSQL, ORM used
  • Authentication: JWT, OAuth, Sessions
  • Testing: Jest, Pytest, Go test, etc.

Step 5: Development Workflow

Check for:

  • .eslintrc, .prettierrc → Linting/Formatting
  • .husky/ → Git hooks
  • Makefile → Build commands
  • scripts/ in package.json → NPM scripts

Step 6: Output Format

Generate a summary using this template:

markdown
# Project: [Name]

## Overview

[1-2 sentence description]

## Tech Stack

| Category  | Technology |
| --------- | ---------- |
| Language  | TypeScript |
| Framework | Next.js 14 |
| Database  | PostgreSQL |
| ...       | ...        |

## Architecture

[Description with simple ASCII diagram if helpful]

## Key Directories

- `src/` - [purpose]
- `lib/` - [purpose]

## Entry Points

- Main: `src/index.ts`
- API: `src/api/`
- Tests: `npm test`

## Conventions

- [Naming conventions]
- [File organization patterns]
- [Code style preferences]

## Quick Commands

| Action  | Command         |
| ------- | --------------- |
| Install | `npm install`   |
| Dev     | `npm run dev`   |
| Test    | `npm test`      |
| Build   | `npm run build` |

Analysis Validation

After completing analysis, verify:

Analysis Validation:
- [ ] All major directories explained
- [ ] Tech stack accurately identified
- [ ] Entry points documented
- [ ] Development commands verified working
- [ ] No assumptions made without evidence

If any items cannot be verified, note them as "needs clarification" in the report.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

CloudAI-X/claude-workflow-v2

convex-backend

Convex backend development guidelines. Use when writing Convex functions, schemas, queries, mutations, actions, or any backend code in a Convex project. Triggers on tasks involving Convex database operations, real-time subscriptions, file storage, or serverless functions.

1,305 187
Explore
CloudAI-X/claude-workflow-v2

parallel-execution

Patterns for parallel subagent execution using Task tool with run_in_background. Use when coordinating multiple independent tasks, spawning dynamic subagents, or implementing features that can be parallelized.

1,305 187
Explore
CloudAI-X/claude-workflow-v2

devops-infrastructure

Guides Docker, CI/CD pipelines, deployment strategies, infrastructure as code, and observability setup. Use when writing Dockerfiles, configuring GitHub Actions, planning deployments, setting up monitoring, or when asked about containers, pipelines, Terraform, or production infrastructure.

1,305 187
Explore
CloudAI-X/claude-workflow-v2

vercel-react-best-practices

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

1,305 187
Explore
CloudAI-X/claude-workflow-v2

designing-apis

Designs REST and GraphQL APIs including endpoints, error handling, versioning, and documentation. Use when creating new APIs, designing endpoints, reviewing API contracts, or when asked about REST, GraphQL, or API patterns.

1,305 187
Explore
CloudAI-X/claude-workflow-v2

managing-git

Manages Git workflows including branching, commits, and pull requests. Use when working with Git, creating commits, opening PRs, managing branches, resolving conflicts, or when asked about version control best practices.

1,305 187
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results