# namespace-explorer

> List all types within a specific namespace or explore namespace structure. Use when you need to understand what's in a namespace or plan where to add new types. (project, gitignored)

- Author: Claude
- Repository: psklarkins/claude-tools
- Version: 20260108102420
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/psklarkins/claude-tools
- Web: https://mule.run/skillshub/@@psklarkins/claude-tools~namespace-explorer:20260108102420

---

---
name: namespace-explorer
description: List all types within a specific namespace or explore namespace structure. Use when you need to understand what's in a namespace or plan where to add new types. (project, gitignored)
---

# Namespace Explorer Skill

This skill explores namespace structure and lists all types within specific namespaces.

**Tool Location:** `C:\Users\Administrator\.claude\skills\namespace-explorer\namespace-explorer.exe`

## When to Use This Skill

- "What types are in the `MyApp.Services` namespace?"
- "Show me everything in `Domain.Models`"
- "List all namespaces in the project"
- "Where should I put my new `OrderValidator` class?"
- Before adding a new type to understand namespace organization
- When refactoring to understand dependencies

## Commands

```bash
# Run via claude-tools CLI
claude-tools skill namespace-explorer <namespace>

# Or run executable directly
C:\Users\Administrator\.claude\skills\namespace-explorer\namespace-explorer.exe <namespace>
```

## What This Skill Does

1. **Lists all types in namespaces:**
   - Classes
   - Interfaces
   - Records
   - Structs
   - Enums
2. **Shows namespace hierarchy:**
   - Parent namespaces
   - Child namespaces
   - Related namespaces
3. **Provides organization insights:**
   - Naming patterns
   - Type counts
   - Suggested location for new types

## Output Format

```
=== NAMESPACE EXPLORER ===

Namespace: MyApp.Services

Types (8):
├── Classes (5)
│   ├── ProductService          → src/Services/ProductService.cs:15
│   ├── OrderService            → src/Services/OrderService.cs:22
│   ├── EmailService            → src/Services/EmailService.cs:10
│   ├── PaymentService          → src/Services/PaymentService.cs:45
│   └── InventoryService        → src/Services/InventoryService.cs:18
│
├── Interfaces (2)
│   ├── IEmailService           → src/Abstractions/IEmailService.cs:8
│   └── IPaymentService         → src/Abstractions/IPaymentService.cs:12
│
└── Records (1)
    └── ServiceResult           → src/Services/ServiceResult.cs:5

Related Namespaces:
├── MyApp.Services.Internal (3 types)
├── MyApp.Services.Validators (5 types)
└── MyApp.Services.Extensions (2 types)

Patterns Detected:
✓ All concrete services end with "Service"
✓ All interfaces start with "I"
✓ Consistent file/type naming
```

## Workflow

When this skill is invoked:

1. **Determine target directory** to explore
2. **Run the NamespaceExplorer tool**
3. **Parse and present results** showing:
   - Namespace hierarchy
   - Types grouped by kind
   - File locations
   - Naming patterns
4. **Suggest** where new types should go

## Integration with Other Skills

**Planning new type:**
1. Run `namespace-explorer` on target namespace
2. Check naming patterns
3. Run `type-collision-detector` to verify name is unique
4. Create type following namespace conventions

**Understanding project structure:**
1. List all namespaces
2. Explore each major namespace
3. Identify areas needing organization

## Example Usage

User asks:
- "What's in the Services namespace?"
- "Where should I put my new EmailValidator?"
- "Show me all namespaces"

Skill will:
1. Run NamespaceExplorer on appropriate directory
2. Parse output
3. Show hierarchy and type counts
4. Suggest naming conventions

## Notes

- Uses Roslyn syntax parsing (fast, no compilation)
- Handles file-scoped namespaces (C# 10+)
- Automatically excludes obj/ and bin/ folders
- Shows full type hierarchy
- Can export to JSON/tree format