{"id":"13792e2e-7fc2-4ee4-aedb-aba1d7f20e04","shortId":"URfyYw","kind":"skill","title":"analyzing-projects","tagline":"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?\"","description":"# Analyzing Projects\n\n### When to Load\n\n- **Trigger**: Onboarding to a new project, \"how does this work\" questions, codebase exploration, understanding unfamiliar code\n- **Skip**: Already familiar with the project structure and patterns\n\n## Project Analysis Workflow\n\nCopy this checklist and track progress:\n\n```\nProject Analysis Progress:\n- [ ] Step 1: Quick overview (README, root files)\n- [ ] Step 2: Detect tech stack\n- [ ] Step 3: Map project structure\n- [ ] Step 4: Identify key patterns\n- [ ] Step 5: Find development workflow\n- [ ] Step 6: Generate summary report\n```\n\n## Step 1: Quick Overview\n\n```bash\n# Check for common project markers\nls -la\ncat README.md 2>/dev/null | head -50\n```\n\n## Step 2: Tech Stack Detection\n\n### Package Managers & Dependencies\n\n- `package.json` → Node.js/JavaScript/TypeScript\n- `requirements.txt` / `pyproject.toml` / `setup.py` → Python\n- `go.mod` → Go\n- `Cargo.toml` → Rust\n- `pom.xml` / `build.gradle` → Java\n- `Gemfile` → Ruby\n\n### Frameworks (from dependencies)\n\n- React, Vue, Angular, Next.js, Nuxt\n- Express, FastAPI, Django, Flask, Rails\n- Spring Boot, Gin, Echo\n\n### Infrastructure\n\n- `Dockerfile`, `docker-compose.yml` → Containerized\n- `kubernetes/`, `k8s/` → Kubernetes\n- `terraform/`, `.tf` files → IaC\n- `serverless.yml` → Serverless Framework\n- `.github/workflows/` → GitHub Actions\n\n## Step 3: Project Structure Analysis\n\nPresent as a tree with annotations:\n\n```\nproject/\n├── src/              # Source code\n│   ├── components/   # UI components (React/Vue)\n│   ├── services/     # Business logic\n│   ├── models/       # Data models\n│   └── utils/        # Shared utilities\n├── tests/            # Test files\n├── docs/             # Documentation\n└── config/           # Configuration\n```\n\n## Step 4: Key Patterns Identification\n\nLook for and report:\n\n- **Architecture**: Monolith, Microservices, Serverless, Monorepo\n- **API Style**: REST, GraphQL, gRPC, tRPC\n- **State Management**: Redux, Zustand, MobX, Context\n- **Database**: SQL, NoSQL, ORM used\n- **Authentication**: JWT, OAuth, Sessions\n- **Testing**: Jest, Pytest, Go test, etc.\n\n## Step 5: Development Workflow\n\nCheck for:\n\n- `.eslintrc`, `.prettierrc` → Linting/Formatting\n- `.husky/` → Git hooks\n- `Makefile` → Build commands\n- `scripts/` in package.json → NPM scripts\n\n## Step 6: Output Format\n\nGenerate a summary using this template:\n\n```markdown\n# Project: [Name]\n\n## Overview\n\n[1-2 sentence description]\n\n## Tech Stack\n\n| Category  | Technology |\n| --------- | ---------- |\n| Language  | TypeScript |\n| Framework | Next.js 14 |\n| Database  | PostgreSQL |\n| ...       | ...        |\n\n## Architecture\n\n[Description with simple ASCII diagram if helpful]\n\n## Key Directories\n\n- `src/` - [purpose]\n- `lib/` - [purpose]\n\n## Entry Points\n\n- Main: `src/index.ts`\n- API: `src/api/`\n- Tests: `npm test`\n\n## Conventions\n\n- [Naming conventions]\n- [File organization patterns]\n- [Code style preferences]\n\n## Quick Commands\n\n| Action  | Command         |\n| ------- | --------------- |\n| Install | `npm install`   |\n| Dev     | `npm run dev`   |\n| Test    | `npm test`      |\n| Build   | `npm run build` |\n```\n\n## Analysis Validation\n\nAfter completing analysis, verify:\n\n```\nAnalysis Validation:\n- [ ] All major directories explained\n- [ ] Tech stack accurately identified\n- [ ] Entry points documented\n- [ ] Development commands verified working\n- [ ] No assumptions made without evidence\n```\n\nIf any items cannot be verified, note them as \"needs clarification\" in the report.","tags":["analyzing","projects","claude","workflow","cloudai-x","agent-skills","ai-agents","claude-code","codex","cursor","skills"],"capabilities":["skill","source-cloudai-x","skill-analyzing-projects","topic-agent-skills","topic-ai-agents","topic-claude-code","topic-codex","topic-cursor","topic-skills","topic-workflow"],"categories":["claude-workflow-v2"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/CloudAI-X/claude-workflow-v2/analyzing-projects","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add CloudAI-X/claude-workflow-v2","source_repo":"https://github.com/CloudAI-X/claude-workflow-v2","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 1352 github stars · SKILL.md body (3,483 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-03T00:52:55.451Z","embedding":null,"createdAt":"2026-04-18T21:54:51.025Z","updatedAt":"2026-05-03T00:52:55.451Z","lastSeenAt":"2026-05-03T00:52:55.451Z","tsv":"'-2':298 '-50':127 '/dev/null':125 '/javascript/typescript':139 '1':79,111,297 '14':309 '2':86,124,129 '3':91,188 '4':96,223 '5':101,264 '6':106,284 'accur':376 'action':186,346 'alreadi':58 'analysi':67,76,191,362,366,368 'analyz':2,4,36 'analyzing-project':1 'angular':158 'annot':197 'api':236,330 'architectur':35,231,312 'ascii':316 'ask':26 'assumpt':386 'authent':253 'bash':114 'boot':167 'build':276,358,361 'build.gradle':149 'busi':207 'cannot':393 'cargo.toml':146 'cat':122 'categori':303 'check':115,267 'checklist':71 'clarif':400 'code':23,56,201,341 'codebas':5,52 'command':277,345,347,382 'common':117 'complet':365 'compon':202,204 'config':220 'configur':221 'container':173 'context':247 'convent':13,335,337 'copi':69 'data':210 'databas':248,310 'depend':135,155 'descript':300,313 'detect':87,132 'dev':351,354 'develop':103,265,381 'diagram':317 'directori':321,372 'django':163 'doc':218 'docker-compose.yml':172 'dockerfil':171 'document':219,380 'echo':169 'entri':326,378 'eslintrc':269 'etc':262 'evid':389 'explain':373 'explor':21,53 'express':161 'familiar':59 'fastapi':162 'file':84,179,217,338 'find':102 'flask':164 'format':286 'framework':153,183,307 'gemfil':151 'generat':107,287 'gin':168 'git':273 'github':185 'github/workflows':184 'go':145,260 'go.mod':144 'graphql':239 'grpc':240 'head':126 'help':319 'hook':274 'huski':272 'iac':180 'identif':226 'identifi':97,377 'infrastructur':170 'instal':348,350 'item':392 'java':150 'jest':258 'jwt':254 'k8s':175 'key':98,224,320 'kubernet':174,176 'la':121 'languag':305 'lib':324 'linting/formatting':271 'load':40 'logic':208 'look':227 'ls':120 'made':387 'main':328 'major':371 'makefil':275 'manag':134,243 'map':92 'markdown':293 'marker':119 'microservic':233 'mobx':246 'model':209,211 'monolith':232 'monorepo':235 'name':295,336 'need':399 'new':19,45 'next.js':159,308 'node.js':138 'node.js/javascript/typescript':137 'nosql':250 'note':396 'npm':281,333,349,352,356,359 'nuxt':160 'oauth':255 'onboard':16,42 'organ':339 'orm':251 'output':285 'overview':81,113,296 'packag':133 'package.json':136,280 'pattern':11,65,99,225,340 'point':327,379 'pom.xml':148 'postgresql':311 'prefer':343 'present':192 'prettierrc':270 'progress':74,77 'project':3,20,37,46,62,66,75,93,118,189,198,294 'purpos':323,325 'pyproject.toml':141 'pytest':259 'python':143 'question':51 'quick':80,112,344 'rail':165 'react':156 'react/vue':205 'readm':82 'readme.md':123 'redux':244 'report':109,230,403 'requirements.txt':140 'rest':238 'root':83 'rubi':152 'run':353,360 'rust':147 'script':278,282 'sentenc':299 'serverless':182,234 'serverless.yml':181 'servic':206 'session':256 'setup.py':142 'share':213 'simpl':315 'skill' 'skill-analyzing-projects' 'skip':57 'sourc':200 'source-cloudai-x' 'spring':166 'sql':249 'src':199,322 'src/api':331 'src/index.ts':329 'stack':10,89,131,302,375 'state':242 'step':78,85,90,95,100,105,110,128,187,222,263,283 'structur':8,63,94,190 'style':237,342 'summari':108,289 'tech':9,88,130,301,374 'technolog':304 'templat':292 'terraform':177 'test':215,216,257,261,332,334,355,357 'tf':178 'topic-agent-skills' 'topic-ai-agents' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-skills' 'topic-workflow' 'track':73 'tree':195 'trigger':41 'trpc':241 'typescript':306 'ui':203 'understand':7,54 'unfamiliar':22,55 'use':14,252,290 'util':212,214 'valid':363,369 'verifi':367,383,395 'vue':157 'without':388 'work':30,50,384 'workflow':68,104,266 'zustand':245","prices":[{"id":"42e2a6cf-ebac-4cf2-a0f9-fcd824af2747","listingId":"13792e2e-7fc2-4ee4-aedb-aba1d7f20e04","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"CloudAI-X","category":"claude-workflow-v2","install_from":"skills.sh"},"createdAt":"2026-04-18T21:54:51.025Z"}],"sources":[{"listingId":"13792e2e-7fc2-4ee4-aedb-aba1d7f20e04","source":"github","sourceId":"CloudAI-X/claude-workflow-v2/analyzing-projects","sourceUrl":"https://github.com/CloudAI-X/claude-workflow-v2/tree/main/skills/analyzing-projects","isPrimary":false,"firstSeenAt":"2026-04-18T21:54:51.025Z","lastSeenAt":"2026-05-03T00:52:55.451Z"}],"details":{"listingId":"13792e2e-7fc2-4ee4-aedb-aba1d7f20e04","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"CloudAI-X","slug":"analyzing-projects","github":{"repo":"CloudAI-X/claude-workflow-v2","stars":1352,"topics":["agent-skills","ai","ai-agents","claude-code","codex","cursor","skills","workflow"],"license":"mit","html_url":"https://github.com/CloudAI-X/claude-workflow-v2","pushed_at":"2026-02-14T18:09:29Z","description":"Universal Claude Code workflow plugin with agents, skills, hooks, and commands","skill_md_sha":"a193b4933acc83dbaecc932eb8f2dedbe4b087e2","skill_md_path":"skills/analyzing-projects/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/CloudAI-X/claude-workflow-v2/tree/main/skills/analyzing-projects"},"layout":"multi","source":"github","category":"claude-workflow-v2","frontmatter":{"name":"analyzing-projects","description":"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?\""},"skills_sh_url":"https://skills.sh/CloudAI-X/claude-workflow-v2/analyzing-projects"},"updatedAt":"2026-05-03T00:52:55.451Z"}}