ReddRadar
Agent skill
code-wizard
Codebase exploration and location finder for the Raamattu Nyt monorepo. Use when finding where specific functionality is implemented, locating constants/tokens/config values, discovering file patterns, or answering "where is X coded?" questions. Helps other skills and agents locate code quickly.
Install this agent skill to your Project
npx add-skill https://github.com/Spectaculous-Code/raamattu-nyt/tree/main/.claude/skills/code-wizard
SKILL.md
Code Wizard
Find what-is-where in the Raamattu Nyt monorepo.
Context Files (Read First)
For structure and layout, read from Docs/context/:
Docs/context/repo-structure.md- Full directory layoutDocs/context/packages-map.md- Package boundaries and imports
Quick Directory Map
raamattu-nyt/
├── apps/
│ ├── raamattu-nyt/src/ # Main Bible app
│ │ ├── pages/ # Route components
│ │ ├── components/ # UI components
│ │ ├── hooks/ # React hooks
│ │ ├── lib/ # Business logic, services
│ │ └── integrations/ # External services (Supabase)
│ └── idea-machina/ # AI prompting app
├── packages/
│ ├── ui/ # Shared shadcn components
│ ├── shared-auth/ # Auth hooks, session
│ ├── shared-content/ # Shared content utils
│ ├── shared-history/ # Reading history
│ ├── shared-voice/ # Audio/TTS
│ └── ai/ # AI utilities
├── supabase/
│ ├── migrations/ # Database DDL
│ └── functions/ # Edge Functions
└── Docs/ # Project documentation
Common Search Patterns
Find Constants/Tokens
# Static string tokens
grep -r "const.*TOKEN\|const.*KEY\|const.*SECRET" --include="*.ts" --include="*.tsx"
# Environment variables
grep -r "import.meta.env\|process.env\|Deno.env" --include="*.ts" --include="*.tsx"
# Query keys (React Query)
grep -r "queryKey.*\[" --include="*.ts" --include="*.tsx"
Find Feature Implementation
# Hooks
grep -r "export.*function use\|export const use" --include="*.ts" --include="*.tsx"
# Services
grep -r "export.*async function\|export const.*= async" apps/raamattu-nyt/src/lib/
# Components
grep -r "export.*const.*=.*\(\)" apps/raamattu-nyt/src/components/
Find Database/API Usage
# Supabase table queries
grep -r "\.from\(['\"]" --include="*.ts" --include="*.tsx"
# RPC function calls
grep -r "\.rpc\(['\"]" --include="*.ts" --include="*.tsx"
# Edge Function invocations
grep -r "functions.invoke\|/functions/v1/" --include="*.ts"
Where Things Are
By Feature Type
| Looking For | Location | Pattern |
|---|---|---|
| React hooks | apps/*/src/hooks/ |
use*.ts |
| UI components | apps/*/src/components/ |
*.tsx |
| Page routes | apps/*/src/pages/ |
*Page.tsx |
| Business logic | apps/*/src/lib/ |
*Service.ts |
| Supabase types | apps/*/src/integrations/supabase/ |
types.ts |
| DB migrations | supabase/migrations/ |
*.sql |
| Edge Functions | supabase/functions/ |
*/index.ts |
| Shared UI | packages/ui/src/ |
*.tsx |
| Auth logic | packages/shared-auth/ |
*.ts |
By Domain
| Domain | Key Files |
|---|---|
| Bible text | lib/bibleService.ts, lib/verseParser.ts, lib/searchService.ts |
| Audio/TTS | lib/audioService.ts, packages/shared-voice/ |
| AI features | lib/aiSummaryService.ts, hooks/useAIQuota.ts, supabase/functions/ai-orchestrator/ |
| Topics | lib/topicEditorUtils.ts, pages/TopicPage.tsx, pages/AdminTopicsPage.tsx |
| User data | hooks/useFeedback.ts, lib/activityLogger.ts |
| Admin | pages/Admin*.tsx, components/admin/ |
Useful Grep Commands
Find All Query Keys
grep -roh "queryKey: \[.*\]" apps/ | sort -u
Find All Routes
grep -r "path=\"/\|<Route" apps/raamattu-nyt/src/App.tsx
Find All Supabase Tables Used
grep -roh "\.from(['\"][^'\"]*['\"])" apps/ | sort -u
Find All RPC Functions Called
grep -roh "\.rpc(['\"][^'\"]*['\"])" apps/ | sort -u
Find Environment Variables
grep -roh "import\.meta\.env\.[A-Z_]*\|Deno\.env\.get(['\"][^'\"]*['\"])" . | sort -u
Find Exports from a File
grep "^export" <file_path>
References
- File locations by feature: See references/locations.md
- Search patterns cookbook: See references/patterns.md
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
Spectaculous-Code/raamattu-nyt
docs-updater
Expert assistant for keeping documentation synchronized with code changes in the KR92 Bible Voice project. Use when updating API docs, maintaining architecture diagrams, syncing README, updating CLAUDE.MD, or generating documentation from code.
Spectaculous-Code/raamattu-nyt
ai-prompt-manager
Expert assistant for managing AI prompts, features, and configuration in the KR92 Bible Voice AI system. Use when creating AI prompts, configuring AI features, managing prompt versions, setting up AI bindings, or working with AI pricing and models.
Spectaculous-Code/raamattu-nyt
performance-auditor
Expert assistant for monitoring and optimizing performance in the KR92 Bible Voice project. Use when analyzing query performance, optimizing database indexes, reviewing React Query caching, monitoring AI call costs, or identifying N+1 queries.
Spectaculous-Code/raamattu-nyt
edge-function-generator
Expert assistant for creating and maintaining Supabase Edge Functions for the KR92 Bible Voice project. Use when creating Edge Functions, setting up CORS, integrating shared modules, adding JWT validation, or configuring environment variables.
Spectaculous-Code/raamattu-nyt
admin-panel-builder
Expert assistant for creating and maintaining admin panel pages in the KR92 Bible Voice project. Use when creating admin pages, building admin components, integrating with admin navigation, or adding admin features.
Spectaculous-Code/raamattu-nyt
lint-fixer
Expert assistant for analyzing and fixing linting and formatting issues in the KR92 Bible Voice project using Biome and TypeScript. Use when fixing lint errors, resolving TypeScript issues, applying code formatting, or reviewing code quality.
Didn't find tool you were looking for?