Agent skill
android-project
Navigate and analyze Android project structure, modules, and dependencies. Use when exploring project structure, finding related files, analyzing dependencies, or locating code patterns.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/android-project
SKILL.md
Android Project Skill
Navigate and analyze Android project structure, modules, and dependencies.
When to Use
- Exploring project structure
- Finding related files
- Analyzing module dependencies
- Understanding package organization
- Locating specific code patterns
Standard Android Project Structure
android-app/
├── app/src/
│ ├── main/java/com/example/app/
│ │ ├── biz/ # Business logic layer
│ │ │ ├── manage/ # Managers (GameManager, UserManager)
│ │ │ ├── service/ # Services (AuthService, SyncService)
│ │ │ ├── repo/ # Repositories
│ │ │ └── util/ # Utilities
│ │ ├── di/ # Dependency injection (Koin/Hilt)
│ │ └── ui/ # Presentation layer
│ │ ├── launcher/ # Screens by feature
│ │ ├── component/ # Reusable components
│ │ ├── navigation/ # NavRoutes, NavHost
│ │ ├── viewmodel/ # ViewModels
│ │ └── theme/ # Theme definitions
│ └── test/ # Unit tests
├── docs/ # Documentation
├── gradle/ # Gradle config
└── CLAUDE.md # AI dev guide
File Patterns
By Layer
| Layer | Pattern | Example |
|---|---|---|
| Manager | biz/manage/**/*Manager*.kt |
GameManagerImpl.kt |
| Service | biz/service/**/*Service*.kt |
AuthService.kt |
| Repository | biz/repo/**/*Repository*.kt |
QuestionRepository.kt |
| ViewModel | ui/viewmodel/*ViewModel.kt |
GameViewModel.kt |
| Screen | ui/launcher/**/*Route.kt |
GameRoute.kt |
| Component | ui/component/**/*.kt |
QzdsGameButton.kt |
| Test | test/**/*Test.kt |
GameManagerImplTest.kt |
Common Search Commands
# Find all ViewModels
find . -name "*ViewModel.kt" -type f
# Find all Route composables
grep -r "@Composable.*fun.*Route" --include="*.kt"
# Find class definition
grep -rn "class GameManager" --include="*.kt"
# Find class usages
grep -rn "GameManager" --include="*.kt" | grep -v "class GameManager"
# Find test file
find . -name "*GameManagerImplTest.kt" -type f
Architecture Navigation
MVVM Layer Flow
UI (Route) → ViewModel → Manager/UseCase → Repository → DataSource
Key File Types
| Purpose | Naming Convention |
|---|---|
| Entry point | LauncherActivity.kt, App.kt |
| DI setup | AppModule.kt, *Module.kt |
| Navigation | NavRoutes.kt, AppNavHost.kt |
| State machine | *Phase.kt, *State.kt |
| Session | Current*Session.kt |
Dependency Analysis
# Show full dependency tree
./gradlew dependencies
# Show specific module dependencies
./gradlew :app:dependencies --configuration implementation
# Check for version conflicts
./gradlew dependencies | grep -E "^\+---|^\\\\---" | grep "->"
Quick Navigation Tips
- Find related files: Search for class name across project
- Trace data flow: Follow imports from UI → ViewModel → Manager
- Find tests: Replace
Impl.ktwithImplTest.kt - Check DI: Look in
AppModule.ktfor registration
Troubleshooting
| Issue | Solution |
|---|---|
| Can't find class | Check import statements, package name |
| Missing dependency | Verify DI module registration |
| Test not found | Ensure test in correct source set |
| Circular dependency | Review DI graph in AppModule |
Command Workflows
# Full codebase exploration
find . -name "*.kt" -type f | head -20 # List Kotlin files
grep -rn "class.*Manager" --include="*.kt" # Find managers
grep -rn "koinViewModel" --include="*.kt" # Find ViewModel injections
# Feature impact analysis
grep -rn "GameManager" --include="*.kt" | wc -l # Count usages
git log --oneline --follow -- "**/GameManager*.kt" # File history
References
Use this skill to quickly locate files and understand relationships.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?