A Mintlify documentation site providing engineering wisdom and best practices for vibe coders (non-engineers using AI coding tools like Claude Code, Codex, Antigravity, etc).
/docs— Mintlify docsite (MDX files + docs.json config)/vibe-coder-docs-skills— Skills for AI agents working with this repo/skill-library— General development skills shared across projects/.claude— Claude Code configuration
- Target audience: non-engineers and early-stage developers using AI coding tools
- Tone: approachable but technically accurate — teach, don't gatekeep
- Every topic should explain why something matters, not just what to do
- Use real-world examples and common mistakes as teaching tools
- Content should be useful to both human readers and AI agents consuming the docs
- Docs live in
/docswithdocs.jsonas the config - Pages are
.mdxfiles (MDX = Markdown + JSX components) - Navigation structure is defined in
docs.json - Run locally with
npx mintlify devfrom the/docsdirectory
- Each MDX file needs frontmatter with
title,description, and optionallyicon - Use Mintlify components:
<Card>,<CardGroup>,<Tip>,<Warning>,<Note>,<Accordion>,<AccordionGroup>,<Steps>,<Step> - Keep pages focused — one concept per page
- Link between related pages liberally