code-wizard

@Spectaculous-Code/code-wizard

0 forks

Updated 4/12/2026

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.

Installation

$npx agent-skills-cli install @Spectaculous-Code/code-wizard

Claude Code

Cursor

Copilot

Codex

Antigravity

Details

RepositorySpectaculous-Code/raamattu-nyt

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

Branchmain

Scoped Name@Spectaculous-Code/code-wizard

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

npx agent-skills-cli list

Skill Instructions

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

File locations by feature: See references/locations.md
Search patterns cookbook: See references/patterns.md

More by Spectaculous-Code

View all

core-ux-detective

Discover, define and canonicalize the core user tasks and user paths of the application. Use when (1) mapping what users can actually do in the app, (2) defining canonical user journeys/flows, (3) creating the AI-readable user model (core-user-model.json), (4) reviewing whether a new feature introduces a new core path, (5) other skills (help, marketing, onboarding) need authoritative task/path definitions to consume. Triggers: "core tasks", "user paths", "user journeys", "UX model", "what can users do", "core flows", "user model", "canonical tasks", file types: core-user-model.json.

landing-page-architect

Product marketing and landing page architect for Raamattu Nyt. Generates landing page copy, feature page copy, and CTA suggestions based on the canonical user model. Translates user paths into benefit narratives and core tasks into user value propositions. Use when (1) creating or updating the main landing page, (2) writing feature page copy, (3) generating marketing messaging for app features, (4) crafting CTAs, (5) translating technical features into user benefits, (6) planning marketing page structure. Triggers: "landing page", "marketing copy", "feature page", "CTA", "value proposition", "markkinointi", "laskeutumissivu", "ominaisuussivu", "benefits copy", "marketing messaging".

topic-manager

Expert assistant for managing biblical topics in the KR92 Bible Voice project. Use when (1) creating/editing topics and their Finnish translations, (2) managing topic relations (related, opposite, broader, narrower), (3) validating Finnish translations and pronunciations with Voikko/Omorfi, (4) reviewing topics marked with qa_status='unchecked', (5) bulk updating topic translations, (6) managing topic aliases and synonyms, or (7) fixing incorrectly translated Finnish topic names.

seo-ptimizer

Search Engine Optimization and AI Search Optimization (GEO) specialist. Use when: (1) optimizing for traditional search (Google, Bing), (2) optimizing for AI search engines (ChatGPT, Perplexity, Google AI Overviews, Claude), (3) implementing schema markup for AI citation, (4) improving Core Web Vitals (LCP, INP, CLS), (5) creating citation-worthy content structure, (6) zero-click optimization, (7) E-E-A-T signal implementation. Expert in GEO (Generative Engine Optimization), structured data, and AI-readable content.