Agent-Skills.md

Agent Skills: 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.

UncategorizedID: Spectaculous-Code/raamattu-nyt/code-wizard

Repository

Spectaculous-Code/raamattu-nyt
Spectaculous-Code

Install this agent skill to your local

pnpm dlx add-skill https://github.com/Spectaculous-Code/raamattu-nyt/tree/HEAD/.claude/skills/code-wizard

Skill Files

Browse the full folder contents for code-wizard.

Download Skill

Loading file tree…

.claude/skills/code-wizard/SKILL.md

Skill Metadata

Name
code-wizard
Description
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.

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 layout
  • Docs/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