# GEO Wiki Agent Skill Guide > Let AI agents manage your knowledge base with one command --- ## 🎯 What is Agent Skill? Agent Skill is GEO Wiki's AI Agent integration capability, allowing AI agents to manage the knowledge base directly through CLI or API. **Core Capabilities**: - 📝 Intelligent content generation - 🏷️ Auto-categorization and tagging - 🌍 Multilingual synchronization - 🎨 Layout optimization - 📊 SEO/GEO optimization --- ## 🚀 Quick Start ### Step 1: Login to Wiki ```bash geo login --url http://localhost:3002 --user admin --pass Admin123 ``` ### Step 2: Publish Document ```bash # Publish from file geo doc create --file ./article.md --category tech # AI generate and publish geo llm generate --title "Product Introduction" --category products ``` ### Step 3: Verify Publication ```bash geo doc list --category tech ``` --- ## 📋 Smart Categorization Rules Agents should automatically categorize documents based on these rules: ### Category Mapping | Content Type | Category Slug | Tags | |--------------|---------------|------| | Product Datasheet | `can-motion` | product, technical-specs | | Product Manual | `can-motion` | product, user-manual | | Protocol Converter | `protocol-adapter` | protocol, converter | | Code Examples | `code-examples` | code, examples | | Quick Start | `support` | quick-start, tutorial | | FAQ | `faq` | faq, troubleshooting | | Technical Tutorial | `support` | tutorial, technical | ### Tag Generation Rules ```yaml # Auto-generate tags based on content tags: - Product model (e.g., UIM342) - Technical features (e.g., CAN-bus, closed-loop) - Application scenarios (e.g., industrial automation) - Content type (e.g., tutorial, datasheet) ``` --- ## 🎨 Layout Standards ### Document Structure Template ```yaml --- title: Document Title slug: url-friendly-slug category: category-slug tags: [tag1, tag2] author: admin description: Description with more than 20 characters language: en notice: "💡 Notice for this page" schema: type: TechArticle datePublished: YYYY-MM-DD dateModified: YYYY-MM-DD --- # Document Title > One-line summary --- ## Product Overview ## Key Features ## Technical Specifications ## Application Scenarios ## Example Code ## Related Documentation --- *Last updated: YYYY-MM-DD | Version: v2.9.0* ``` ### Auto-generate Notice Rules | Content Type | Notice Template | |--------------|-----------------| | Product Doc | "📋 This page contains detailed technical specs for {product}" | | Tutorial | "💡 This tutorial requires {prerequisites}, estimated {time} to complete" | | FAQ | "❓ Frequently asked questions, click to expand for details" | | Code Example | "💻 This page contains ready-to-run example code" | | Safety Alert | "⚠️ Important safety notice, please read carefully before proceeding" | --- ## 🔧 CLI Command Reference ### Document Management ```bash # Create document geo doc create -f ./doc.md -c category -T "tag1,tag2" # Update document geo doc update --slug doc-slug -f ./updated.md # Delete document geo doc delete --slug doc-slug # List documents geo doc list --category products --json # Get single document geo doc get --slug doc-slug ``` ### Category Management ```bash # Create category geo category create --name "Category Name" --slug category-slug # List categories geo category list --json ``` ### AI Features ```bash # AI generate document geo llm generate --title "Title" --category cat --lang en # AI translate document geo llm translate --slug doc-slug --target-lang zh # AI optimize document geo llm optimize --slug doc-slug --mode replace ``` --- ## 📊 Complete Workflow Examples ### Scenario: Batch Import Product Documents ```bash #!/bin/bash # Batch import product documents # Login geo login --url http://localhost:3002 --user admin --pass Admin123 # Create category (if not exists) geo category create --name "Products" --slug products # Batch publish for f in ./products/*.md; do echo "Publishing: $f" geo doc create -f "$f" -c products -T "products,import" done # Verify geo doc list --category products --json ``` ### Scenario: Multilingual Sync ```bash #!/bin/bash # Auto-translate after publishing Chinese document # Publish Chinese version geo doc create -f ./doc-zh.md -c products # Translate to English geo llm translate --slug doc-slug --target-lang en # Verify geo doc get --slug doc-slug --lang en ``` --- ## 🤖 Agent Integration Configuration ### Claude Code / OpenClaw ```json { "tools": { "geo-wiki": { "command": "geo", "args": ["--url", "http://localhost:3002"] } } } ``` ### Environment Variables ```bash export GEO_URL=http://localhost:3002 export GEO_USER=admin export GEO_PASS=Admin123 ``` --- ## 📚 API Reference ### Authentication ```bash # Login to get Cookie curl -X POST http://localhost:3002/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"Admin123"}' \ -c cookies.txt ``` ### Document Operations | Function | Method | Path | |----------|--------|------| | List Documents | GET | `/api/v1/docs` | | Get Document | GET | `/api/v1/docs/:slug` | | Create Document | POST | `/api/v1/admin/docs` | | Update Document | PUT | `/api/v1/admin/docs/:slug` | | Delete Document | DELETE | `/api/v1/admin/docs/:slug` | | Search Documents | GET | `/api/v1/docs/search?q=keyword` | ### AI Features | Function | Method | Path | |----------|--------|------| | AI Generate | POST | `/api/v1/llm/generate` | | AI Translate | POST | `/api/v1/llm/translate` | | AI Optimize | POST | `/api/v1/llm/optimize` | | AI Analyze | POST | `/api/v1/llm/analyze` | --- ## ❓ FAQ **Q: Does Agent Skill require additional payment?** A: No. Agent Skill is a built-in feature of GEO Wiki, free to use. **Q: Which AI agents are supported?** A: All agents that support CLI or API calls. **Q: How to handle CSRF issues?** A: When using Cookie authentication, CSRF tokens are handled automatically. If issues occur, re-login to get a fresh Cookie. --- ## 🚀 Next Steps 1. **Try Agent Skill** → Start GEO Wiki locally 2. **Read CLI Documentation** → Complete command reference 3. **Read AI Features** → Learn about AI generation and optimization --- *Last updated: 2026-05-26 | Version: v2.9.0*