Help us improve
Share bugs, ideas, or general feedback.
From popkit-core
Analyzes unfamiliar codebases via interactive workflow: detects structure, maps architecture/patterns, reviews dependencies/quality/tests, suggests improvements. Quick/standard/deep modes with focus options.
npx claudepluginhub jrc1883/popkit-ai --plugin popkit-coreHow this skill is triggered — by the user, by Claude, or both
Slash command
/popkit-core:pop-analyze-projectThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Perform deep analysis of a codebase to understand its architecture, patterns, dependencies, and opportunities for improvement.
Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Breaks plans, specs, or PRDs into thin vertical-slice issues on the project issue tracker using tracer bullets. Useful for converting high-level work into grabbable implementation tickets.
Share bugs, ideas, or general feedback.
Perform deep analysis of a codebase to understand its architecture, patterns, dependencies, and opportunities for improvement.
Core principle: Understand before changing. Map before navigating.
Trigger: /popkit:project analyze command or when starting work on unfamiliar project
| Flag | Description |
|---|---|
--json | Output structured JSON instead of markdown, save to .claude/analysis.json |
--quick | Quick summary only (5-10 lines) |
--focus <area> | Focus analysis: arch, deps, quality, patterns |
Directory structure, entry points, file counts by type.
Package managers, frameworks (Next.js, React, Vue, Express, FastAPI, Rust), databases (Supabase, Prisma, MongoDB, PostgreSQL).
Frontend (component structure, state management, routing), Backend (API design, service layer, database access), Common (error handling, logging, configuration).
Linting config, TypeScript strictness, TODO/FIXME comments.
Test files, test frameworks, coverage reports.
Count, outdated packages, security vulnerabilities.
CI config, Docker, deployment configuration.
# [Project Name] Analysis Report
## Summary
- **Type**: [Web App / API / CLI / Library]
- **Stack**: [Primary technologies]
- **Size**: [Files, Lines of code]
- **Health**: [Good / Needs attention / Critical issues]
## Technology Stack
### Frontend
- Framework: [Next.js 14 / React / Vue / etc.]
- Styling: [Tailwind / styled-components / etc.]
- State: [Redux / Zustand / Context]
### Backend
- Runtime: [Node.js / Python / Rust / Go]
- Framework: [Express / FastAPI / Actix]
- Database: [PostgreSQL / MongoDB / etc.]
### DevOps
- CI/CD: [GitHub Actions / GitLab CI / etc.]
- Deployment: [Vercel / AWS / etc.]
- Container: [Docker / etc.]
## Architecture
### Key Patterns
- [Pattern 1]: [Where used]
- [Pattern 2]: [Where used]
### Entry Points
- Main: `[path]`
- API: `[path]`
- Tests: `[path]`
## Code Quality
| Metric | Value | Status |
| ----------------- | -------------------- | ------------ |
| Linting | [Configured/Missing] | [OK/Warning] |
| TypeScript Strict | [Yes/No] | [OK/Warning] |
| Test Coverage | [X%] | [OK/Warning] |
| TODO Comments | [N] | [OK/Warning] |
## Recommendations
### Critical
1. [Issue requiring immediate attention]
### High Priority
1. [Important improvement]
### Nice to Have
1. [Enhancement suggestion]
## Next Steps
1. Run `/generate-mcp` to create project-specific tools
2. Run `/generate-skills` to capture discovered patterns
3. Run `/setup-precommit` to configure quality gates
When --json flag is provided, saves to .claude/analysis.json:
{
"project_name": "project-name",
"project_type": "nextjs",
"analyzed_at": "2026-01-30T00:00:00Z",
"frameworks": [{ "name": "nextjs", "confidence": 0.95, "version": "14.0.0" }],
"patterns": [
{
"name": "pattern-name",
"category": "architecture",
"confidence": 0.85,
"examples": ["path1", "path2"],
"description": "Description"
}
],
"recommended_skills": ["skill1", "skill2"],
"recommended_agents": ["agent1", "agent2"],
"commands": {},
"quality_metrics": {}
}
Based on detected patterns:
| Pattern | Recommended Skill | Priority |
|---|---|---|
| nextjs + vercel-config | project:deploy | high |
| prisma OR drizzle | project:db-migrate | high |
| supabase | project:supabase-sync | medium |
| docker-compose | project:docker-dev | medium |
| feature-flags | project:feature-toggle | low |
| Pattern | Recommended Agent |
|---|---|
| Large codebase (>100 files) | performance-optimizer |
| React/Vue components | accessibility-guardian |
| API routes | api-designer |
| Security-sensitive | security-auditor |
| Low test coverage | test-writer-fixer |
Called by:
/analyze-project command/init-projectInforms: