Project Analyzer

What it does

The Project Analyzer skill helps AI agents understand and classify software projects based on their manifest files and directory structure. It identifies project roots by searching for common package manager files (like package.json, requirements.txt, etc.) and then determines the project type – frontend, backend, fullstack, library/package, CLI, or mobile – based on dependencies and file organization. This analysis provides a foundation for further automated tasks related to code understanding and management.

When to use it

• Automated Code Analysis: To automatically categorize projects for vulnerability scanning or code quality checks.
• Project Onboarding: Quickly identify the technology stack used in a new project during onboarding processes.
• Dependency Management: Understand the project type to suggest appropriate dependency updates or tooling.
• Monorepo Navigation: Help navigate and understand complex monorepos with multiple projects.
• Framework Identification: Determine which frameworks (e.g., React, Vue, Express) are being used in a codebase.

Key capabilities

• Project Root Detection: Locates the root directory of a project by searching for manifest files.
• Monorepo Handling: Detects and handles projects structured as monorepos.
• Project Type Classification: Identifies whether a project is frontend, backend, fullstack, library/package, CLI, or mobile.
• Framework Identification: Recognizes common frameworks used in each project type (e.g., Next.js, Django, React Native).
• Manifest File Parsing: Parses various package manager files to extract relevant information.

Example prompts

• "Analyze this directory and tell me what kind of project it is: /path/to/project"
• "What frameworks are being used in this Node.js project?"
• "Is this a monorepo? If so, how many package.json files does it contain?"

Tips & gotchas

• The skill relies on the presence of standard manifest files to identify projects. Projects without these files may not be accurately analyzed.
• Accuracy in project type detection depends on the clarity and consistency of the project's directory structure and dependencies.