| name | personal-blog |
| description | Skill for operating the Personal Blog (Antigravity OS). Covers content management (posts, garden notes, projects), user interactions (comments, reactions, guestbook, bookmarks), AI services (text/image/video generation, web search, web read, learning tools), admin operations, and system management. Use when user wants to interact with their blog through MCP tools or discuss blog architecture. |
Personal Blog Skill — Antigravity OS
Full operational guide for AI agents interacting with the Personal Blog system.
System Overview
Stack: Next.js 16 (App Router) + Prisma ORM (SQLite dev / PostgreSQL prod) + Tailwind CSS 4 + shadcn/ui
Auth: Cookie-based sessions (user_id, user_role, is_admin cookies)
AI Services: OpenAI GPT-4o, DALL-E 3, Replicate, Google Custom Search
Deployment: Docker + Caddy reverse proxy
MCP Server: mcp-server/ directory, stdio transport, 49+ tools
Authentication
Always authenticate first before using auth-required tools:
1. Call auth_login(email, password)
2. Session cookies persist across all subsequent calls
3. Admin tools require role=admin
Roles: user (default), admin (set via ADMIN_EMAIL env or role field)
Content Types
Blog Posts ("The Surface")
- Full articles with Markdown content
- Features: tags, excerpts, cover images, reading time, view counts
- Learning: recall questions, mnemonics, AI summaries
- Create: admin_create_post → Read: list_posts / get_post → React: react_to_post
Garden Notes ("The Lab")
- Digital garden with wiki-like knowledge notes
- Status lifecycle:
seedling → growing → evergreen
- Features: spaced repetition, inter-note links, tags
- Create: admin_create_garden_note → Read: list_garden_notes / get_garden_note
Projects ("The Forge")
- Portfolio projects with tech stack, progress tracking
- Features: live URLs, GitHub links, priority, status
- Create: admin_create_project → Read: list_projects / get_project
Hub ("Now Page")
- Current learning, reading list, music, pinned repos
- Read: get_hub → Update: admin_update_hub
Common Workflows
Publish a New Blog Post
1. auth_login(admin_email, password)
2. admin_create_post({
title: "...",
slug: "my-new-post",
content: "# Markdown here...",
published: true,
tags: ["typescript", "tutorial"]
})
3. summarize_post({ postId: "<returned_id>" })
4. ai_recall_questions({ title: "...", content: "..." })
Explore Blog Content
1. list_posts({ published: "true", limit: "10" })
2. get_post({ slug: "post-slug" }) // full content + comments
3. search_content({ query: "how does X work?" })
Manage Digital Garden
1. auth_login(admin_email, password)
2. admin_create_garden_note({
title: "React Server Components",
slug: "react-server-components",
content: "...",
status: "seedling",
tags: ["react", "architecture"]
})
3. ai_chunk_detect({ title: "...", content: "..." })
AI-Powered Research
1. ai_web_search({ query: "latest TypeScript features" })
2. ai_web_read({ url: "https://..." })
3. ai_text_generate({ prompt: "Summarize this research..." })
4. ai_image_generate({ prompt: "Blog header for TypeScript article" })
User Engagement
1. auth_login(email, password)
2. create_comment({ content: "Great post!", postId: "..." })
3. react_to_post({ postId: "...", emoji: "🔥" })
4. toggle_bookmark({ type: "post", id: "..." })
5. sign_guestbook({ name: "...", message: "..." })
Admin Site Configuration
1. auth_login(admin_email, password)
2. admin_get_settings()
3. admin_update_settings({
siteName: "My Blog",
memorizationMode: true,
activeRecall: true,
themeColor: "#10b981"
})
API Tool Reference (Quick)
Public Tools (No Auth)
| Tool | Purpose |
|---|
health_check | API reachability check |
system_status | Database health |
system_stats | Aggregate counts |
list_posts | Browse posts (filter: published, featured, tag, limit) |
get_post | Read single post by slug |
list_projects | All projects |
get_project | Single project by slug |
list_garden_notes | All garden notes |
get_garden_note | Single note by slug |
list_comments | Comments for a post/note |
get_reactions | Reaction counts for a post |
list_guestbook | All guestbook entries |
get_hub | Now page data |
search_content | AI-powered semantic search |
list_subscriptions | Email subscriptions |
create_subscription | Subscribe to updates |
summarize_post | AI summarize a post |
Authenticated Tools
| Tool | Purpose |
|---|
auth_login | Start session |
auth_register | New account |
auth_logout | End session |
auth_check | Verify session |
react_to_post | Like/react to post |
create_comment | Post comments |
toggle_bookmark | Bookmark content |
list_bookmarks | View saved items |
get_user_profile | Profile data |
update_user_profile | Edit profile |
change_password | Security |
get_user_stats | Activity stats |
get_user_badges | Earned badges |
get_user_activity | Recent activity feed |
get_ai_history | AI artifact history |
AI Service Tools
| Tool | Purpose |
|---|
ai_text_generate | GPT-4o text generation |
ai_image_generate | DALL-E 3 images |
ai_video_generate | Zeroscope video generation |
ai_web_read | Extract webpage content |
ai_web_search | Google Custom Search |
ai_chunk_detect | Decompose into learning chunks |
ai_mnemonic_generate | Memory anchors |
ai_recall_questions | Active recall questions |
ai_verify_knowledge | Verify answer correctness |
ai_delete_artifact | Remove AI artifact |
Admin Tools (Requires Admin Login)
| Tool | Purpose |
|---|
admin_list_posts | All posts including drafts |
admin_create_post | Create blog post |
admin_list_projects | All projects |
admin_create_project | Create project |
admin_update_project | Update project |
admin_list_garden | All garden notes |
admin_create_garden_note | Create garden note |
admin_get_hub | Hub data |
admin_update_hub | Update now page |
admin_get_settings | Site settings |
admin_update_settings | Update settings |
Database Schema (Key Models)
- User — id, email, password, name, bio, role, avatar, badges, bookmarks
- Post — title, slug, content, excerpt, published, featured, tags, reactions, comments, recallQuestions, mnemonics
- GardenNote — title, slug, content, status (seedling/growing/evergreen), spaced repetition fields
- Project — title, slug, description, techStack, status, progress, liveUrl, githubUrl
- Comment — content, author, post/gardenNote, threaded replies (parentId)
- Reaction — emoji, author, post
- Bookmark — user, post/gardenNote/project
- NowPage — learning, readingList, listeningTo, githubRepos
- SiteSettings — siteName, theme, feature toggles, social URLs
- AIArtifact — type, prompt, result, user
- Subscription — email, categories, frequency, active
- GuestbookEntry — name, message, website
Project Structure
personal_blog/
├── src/app/api/ # 49+ API routes (Next.js App Router)
│ ├── auth/ # Login, register, OAuth, password reset
│ ├── posts/ # Public post CRUD + reactions
│ ├── projects/ # Public project listing
│ ├── garden/ # Digital garden notes
│ ├── comments/ # Threaded comments
│ ├── reactions/ # Emoji reactions
│ ├── guestbook/ # Guestbook entries
│ ├── hub/ # Now page data
│ ├── search/ # Semantic search + AI Q&A
│ ├── subscriptions/ # Email subscriptions
│ ├── summarize/ # AI post summarization
│ ├── upload/ # File uploads
│ ├── user/ # Profile, settings, stats, badges, bookmarks
│ ├── ai/ # AI services (text, image, video, web, learning)
│ ├── admin/ # Admin CRUD for all content types + settings
│ └── system/ # Health checks, stats
├── src/components/ # React UI components
├── src/lib/ # Shared utilities (auth, prisma, email, ai)
├── prisma/ # Schema + migrations
├── mcp-server/ # MCP Server (this skill's implementation)
├── skills/ # AI skill definitions (ASR, LLM, TTS, etc.)
├── compose.yml # Docker deployment
└── Caddyfile # Reverse proxy config
Environment Variables
| Variable | Purpose |
|---|
DATABASE_URL | Prisma DB connection string |
ADMIN_EMAIL | Auto-admin user email |
ADMIN_PASSWORD | Admin password |
OPENAI_API_KEY | GPT-4o + DALL-E 3 |
GEMINI_API_KEY | Gemini AI |
GOOGLE_API_KEY | Google Custom Search |
GOOGLE_CX | Search engine ID |
REPLICATE_API_TOKEN | Video generation |
GOOGLE_CLIENT_ID | OAuth |
GOOGLE_CLIENT_SECRET | OAuth |
GOOGLE_REDIRECT_URI | OAuth callback |
Tips
- Slugs are auto-normalized: lowercased, trimmed, spaces→hyphens
- View counts auto-increment on GET by slug
- Posts support both published and draft states
- Garden notes use spaced repetition:
reviewInterval in days
- AI artifacts are saved to the database when
userId is provided
- The hub/now page uses JSON strings for structured data (parse them)
- Comments are threaded: use
parentId for replies
- Bookmarks toggle: calling twice removes the bookmark
