UltraCode — Claude Code Skill

Auto-activated for: TS/JS/Python/C#/Go/Rust/Java/C++/Swift/Kotlin/Zig/Bash code analysis

When to Use

ALWAYS use instead of Grep/Glob — 5-10x faster, understands meaning.

Supported Languages

Stacktrace Diagnosis

analyze_stacktrace

Parse and diagnose stacktraces from any language. Auto-detects language, resolves frames to code graph entities, classifies errors, runs backwards trace and impact analysis.

analyze_stacktrace({
  stacktrace: `TypeError: Cannot read property 'name' of undefined
    at processUser (src/users.ts:42:15)
    at handleRequest (src/server.ts:100:5)`,
  format: "text"         // text | json | mermaid
})

Supported languages: JS/TS (V8/Node), Python traceback, Java/Kotlin (Caused by chains), C#/.NET, Go goroutine panics, Rust panic/RUST_BACKTRACE, C/C++ (GDB/ASAN), Zig.

Returns: error category, severity, crash location, call chain, callers, suggested fixes, Mermaid diagram. With highlightRecentChanges: recentChangeSummary + crashPointHistory.

Architecture Diagrams

getarchitecturediagram

Generate architecture diagrams in Mermaid, Graphviz DOT, or D2 format.

get_architecture_diagram({
  entryPoint: "src/server.ts",  // or omit for project overview
  depth: 2,                     // 1=files, 2=classes, 3=methods
  dataFlowLevel: 1,             // 0=none, 1=types, 2=params, 3=fields
  format: "mermaid"
})

Database Schema

getdatabaseschema

Show database schema from SQL, Prisma, ORM models (TypeORM, Sequelize, JPA, EF Core, Django, SQLAlchemy, GORM, Dapper, linq2db), and Redis key patterns.

get_database_schema({
  tableName: "users",          // partial match filter
  dbEngine: "postgres",       // postgres/mysql/clickhouse/redis/sqlite/mssql
  includeRelationships: true   // FK and code links
})

Security Tools

taint_analysis

Interprocedural taint analysis: trace untrusted data from sources to sinks.

taint_analysis({
  category: "missing_auth",  // sql_injection | xss | command_injection | path_traversal | ssrf | prototype_pollution | missing_auth
  offset: 0, limit: 10
})

Code Quality

detect_patterns

Detect anti-patterns, best-patterns, code smells, and optimization opportunities. 100+ rules across 6 languages. Supports highlightRecentChanges to annotate matches with recently-changed entity status.

detect_patterns({
  category: "anti-pattern",    // anti-pattern | best-pattern | code-smell | optimization
  tags: ["performance"],
  severity: "high",
  highlightRecentChanges: true  // annotate matches with Prolly Tree status
})

checkentitypatterns

Check specific entity for patterns with Big-O analysis.

analyzestatechaos

Detect scattered state, race conditions, C# anti-patterns (async-void, mutable-static, god-service). Supports highlightRecentChanges to identify recently modified chaotic entities.

graph_metrics

Graph-based architecture metrics.

graph_metrics({
  metric: "pagerank",    // pagerank | louvain | centrality | bus_factor
  topN: 10,
  persist: true          // store in entity metadata
})

analyzeapiimpact

Impact of API contract changes across Swagger/OpenAPI, Protobuf/gRPC, and GraphQL.

analyze_api_impact({
  contractType: "swagger",   // swagger | protobuf | graphql | auto
  changedFile: "api/openapi.yaml"
})

Code Modification via MCP

Automatic Validation

All code modifications (modifycode, addmember, createfile, renamesymbol) automatically run linting and error checking.

Safe Modification Workflow

1. semantic_search query="target code"       # Find what to modify
2. get_members filePath="file.ts"            # Get entity IDs
3. analyze_code_impact entityId="..."        # Check what breaks
4. create_snapshot description="Before..."   # Backup
5. modify_code entityId="..." preview=true   # Preview changes
6. modify_code entityId="..." preview=false  # Apply + auto-validate

Available Modification Tools

modify_code — Replace Entity Code

modify_code({
  entityId: "src/utils.ts::processData",
  newCode: `function processData(input: string): Result { ... }`,
  preview: true
})

rename_symbol — Smart Rename

rename_symbol({ entityName: "oldName", newName: "newName", preview: true })

add_member — Add to Class/Interface

add_member({ filePath: "file.ts", entityId: "MyClass", memberCode: "...", position: "end" })

create_file — Create New File

create_file({ filePath: "new-file.ts", content: "...", updateGraph: true })

Rollback & Safety

History & Time Travel

get_entity_history({ entityId: "src/auth.ts::login", limit: 10 })
diff_commits({ from: "abc123", to: "def456" })

Merge Tools

Common Workflows

1. Understanding New Project

1. detect_technology_stack                   # Detect stack
2. get_graph_stats                           # View statistics
3. get_architecture_diagram depth=2          # Visual overview
4. analyze_hotspots metric="complexity"      # Find complex code
5. semantic_search query="entry point"       # Find entry points

2. Diagnosing an Error

1. analyze_stacktrace stacktrace="..." highlightRecentChanges=true  # Parse, diagnose, show recent changes
2. get_members filePath="crash_file.ts"     # Explore crash location
3. analyze_code_impact entityId="..." highlightRecentChanges=true   # What depends on crash point + recent changes

3. Security Audit

1. taint_analysis category="sql_injection"  # Find injection vulnerabilities
2. taint_analysis category="missing_auth"   # Find unprotected endpoints
3. detect_patterns category="anti-pattern" tags=["security"]

4. Finding Problematic Code

semantic_search minCyclomatic=10             # Complex code
semantic_search hasAwaits=true hasExceptions=false  # Async without try/catch
semantic_search hasDocumentation=false       # Undocumented

Tool Reference

Search

Analysis

Entity & Graph

Related Skills

• ultracode-trace — Debugging, flow analysis, "why not called", stacktrace backwards trace
• ultracode-autodoc — Project memory with auto-updated code refs, find code by business meaning

Multi-Agent Worktree

Multiple AI agents can work in parallel on different branches using git worktrees.

// Create worktree for a new agent
spawn_agent_worktree({ branch: "feature/auth", baseBranch: "main" })

// Check active agents
list_worktree_agents({ includeInactive: true })

// Get full repo topology
get_worktree_info()

Key: All worktrees of the same repo share a single repoIdentity — no index duplication.

Cross-Project Support

index directory="D:\\other\\project"
semantic_search query="auth" projectPath="D:\\other\\project"

Storage: %LOCALAPPDATA%\UltraCode\projects\{hash}/