One-click install
npx skills add https://github.com/miethe/ai-scratchpad --skill symbols
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: symbols
Source: https://github.com/miethe/ai-scratchpad/tree/main/.claude/skills/symbols
Command: npx skills add https://github.com/miethe/ai-scratchpad --skill symbols

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill eliminates token inefficiency in codebase navigation, slow code discovery, and difficulty understanding architectural patterns by providing a structured, queryable view of your entire codebase.

Core Features & Use Cases

  • Token-Efficient Code Discovery: Query symbols by name, kind, domain, or path without loading entire files, reducing token usage by 60-95%.
  • Architectural Layer Awareness: Load specific architectural layers (e.g., routers, services) for targeted backend development, achieving 50-80% additional token efficiency.
  • Precise Code References: Get exact file paths and line numbers for functions, classes, components, and types, enabling immediate context lookup.
  • Use Case: When implementing a new feature, quickly find existing patterns and relevant components/services across UI and API domains without consuming large token amounts, ensuring you build on established conventions.

Quick Start

Use the symbols skill to query for all React components with "Card" in their name within the UI domain.

Frequently Asked Questions about symbols

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce token usage when navigating large codebases?

Token-efficient codebase navigation queries pre-generated symbol graphs to retrieve function, class, and component metadata without loading full files, reducing token consumption by 60-95% compared to traditional file-based approaches.

Can I query symbols by specific architectural layers like services or routers?

Yes, architectural layer awareness lets you load domain- and layer-specific symbols—such as API routers or backend services—achieving 50-80% additional token efficiency by targeting only relevant code sections.

How do I find React components and functions across my codebase without loading every file?

Query symbols by name, kind, domain, or path to locate components, functions, classes, and types instantly with exact file paths and line numbers, enabling immediate context lookup across UI and API domains.

What information does a symbol query return?

Symbol queries return structured metadata including name, kind, file path, line number, function signature, summary, and architectural layer, conforming to Schema v2.0 and separating test files from implementation code.

Can I use symbols to understand architectural patterns in my codebase?

Yes, architectural analysis via symbol graphs reveals patterns and conventions across your codebase, enabling you to build new features on established patterns while maintaining consistency without loading entire files.

Does this work with both frontend and backend code?

Symbols support UI, Web, API, and shared domains, making it applicable to feature exploration and pattern matching across frontend components, backend services, and shared utilities in a single query interface.