vibe teacher

You own a codebase you can't read because an AI wrote it for you. This skill bridge the gap between "vibe coding" and actually understanding your project. It explains your architecture in plain English, maps your files, and audits your code for security risks without you needing to know a single line of syntax.

What it does

• Architectural tours explaining how your frontend, backend, and database interact using simple analogies.
• Code quality scoring providing a 0-100 grade across security, structure, and maintainability with cited evidence.
• Security auditing that flags leaked keys, SQL injection risks, and missing authentication.
• Interactive learning through progressive lessons, quizzes, and a jargon-free glossary.
• Automated fix plans generating ready-to-paste prompts to resolve identified code issues.

How it works

1. Scan: Run the local scanner to map the project structure, dependencies, and environment variables.
2. Teach: Request a "tour" or "lesson" to get a breakdown of how a specific action, like a button click, flows through the system.
3. Audit: Invoke "score" or "security" to receive a structured report with specific file and line citations.
4. Improve: Use "fix-plan" to generate instructions for your AI editor to repair vulnerabilities or technical debt.

Frameworks & tools

Works with Node.js, React, Next.js, Express, Python (Flask/FastAPI/Django), Supabase, Firebase, and static HTML. Requires Node.js 18+ for the initial project scan.

Why this beats prompting it yourself

Generic AI explanations often hallucinate or use overly technical jargon that beginners can't follow. This skill uses a specialized scanner to ground every explanation in your actual file paths and line numbers, ensuring the advice is factually accurate to your specific repo.

Use cases

• Codebase onboarding for beginners who used AI to generate an app but don't know how it works.
• Pre-deployment checks to ensure no API keys or secrets were accidentally committed to the repository.
• Technical debt reduction by identifying "needs work" areas and generating prompts to refactor them.
• Skill building for designers or product managers who want to understand the "plumbing" of their web tools.

Known limitations

Requires Node.js 18+ for the scanner script. Large projects (over 25 source files) are automatically split into multiple lessons rather than one single overview.