markdown-based skill indexing with full-text search
Indexes markdown files containing code skills and knowledge into a local SQLite database with FTS5 (Full-Text Search 5) enabled, enabling semantic keyword matching without vector embeddings or external infrastructure. The system parses markdown structure (headings, code blocks, metadata) and builds inverted indices for fast retrieval of skill documentation by natural language queries. No external vector DB or embedding service required — all indexing and search happens locally.
Unique: Uses SQLite FTS5 for keyword-based retrieval instead of vector embeddings, eliminating dependency on external embedding services (OpenAI, Cohere) and vector databases while maintaining sub-millisecond local search performance
vs alternatives: Simpler and faster to set up than Pinecone/Weaviate RAG stacks for developers who prioritize zero infrastructure over semantic similarity
ai cli skill injection via context augmentation
Retrieves indexed skills from the local SQLite database and injects them into the context window of AI coding CLIs (Claude Code, Cursor, Gemini CLI, GitHub Copilot) as formatted markdown or structured prompts. The system acts as a middleware layer that intercepts queries, searches the skill index, and prepends relevant documentation to the AI's input context before sending to the LLM. Supports multiple CLI integrations through adapter patterns.
Unique: Implements RAG-like behavior without vector embeddings by using FTS5 keyword matching and injecting matched skills directly into CLI context windows, designed specifically for AI coding assistants rather than generic LLM applications
vs alternatives: Lighter weight than full RAG pipelines (no embedding model, no vector DB) while still enabling skill-aware code generation in popular AI CLIs
cli command interface for skill management
Provides a command-line interface for managing the skill library (add, remove, search, list, export) without requiring programmatic API calls. Commands include `wicked-brain add <file>`, `wicked-brain search <query>`, `wicked-brain list`, `wicked-brain export`, enabling developers to manage skills from the terminal. Supports piping and scripting for automation.
Unique: Provides a full-featured CLI for skill management (add, search, list, export) enabling terminal-based workflows and shell script integration without requiring a GUI or API client
vs alternatives: More scriptable and automation-friendly than GUI-based knowledge management tools
skill library management with markdown versioning
Provides a structured system for organizing, storing, and versioning coding skills as markdown files with optional metadata (tags, difficulty, language, category). Skills are stored in a flat or hierarchical directory structure and can be edited directly in any text editor. The system tracks which skills are indexed and provides utilities to add, update, and remove skills from the index without requiring a database UI or special tooling.
Unique: Treats skills as first-class markdown files with Git versioning rather than database records, enabling developers to manage their knowledge base using standard text editors and version control workflows
vs alternatives: More portable and version-control-friendly than proprietary knowledge base tools (Notion, Obsidian plugins) while remaining compatible with standard developer workflows
zero-infrastructure local knowledge retrieval
Executes all knowledge indexing and retrieval operations locally on the developer's machine using SQLite FTS5, eliminating the need for external services, API keys, or cloud infrastructure. The entire skill database is stored as a single SQLite file that can be backed up, versioned, or shared via Git. No network calls, no rate limits, no vendor lock-in — all operations complete in milliseconds on local hardware.
Unique: Deliberately avoids external dependencies (vector DBs, embedding APIs, cloud services) by using only SQLite FTS5, making it the only RAG-adjacent system that requires zero infrastructure setup or API credentials
vs alternatives: Eliminates operational complexity and cost of vector database services (Pinecone, Weaviate) while maintaining offline-first privacy guarantees that cloud-based RAG systems cannot provide
multi-cli adapter framework for skill injection
Provides an extensible adapter pattern for integrating the skill library with multiple AI coding CLIs through standardized interfaces. Each CLI adapter handles the specific protocol, context format, and API of its target tool (Claude Code's prompt format, Cursor's context injection, Gemini CLI's request structure). New adapters can be added by implementing a simple interface without modifying core indexing logic.
Unique: Uses adapter pattern to abstract CLI-specific integration details, allowing a single skill library to work across Claude Code, Cursor, Gemini CLI, and custom tools without duplicating indexing or retrieval logic
vs alternatives: More flexible than CLI-specific plugins because adapters are decoupled from core indexing, enabling skill library reuse across tools without reimplementing search
query-to-skill matching via fts5 keyword expansion
Converts natural language queries into FTS5 search expressions by tokenizing, normalizing, and optionally expanding queries with synonyms or related terms. The system handles common query patterns (e.g., 'how do I X' → search for skill tags matching X) and applies FTS5 operators (AND, OR, phrase matching) to improve precision. No machine learning or semantic models — purely lexical matching with heuristic query expansion.
Unique: Implements heuristic-based query expansion for FTS5 to handle natural language variations without semantic embeddings, using rule-based synonym mapping and query pattern recognition
vs alternatives: Simpler and faster than semantic search (no embedding inference latency) while still handling common query variations through configurable synonym expansion
skill metadata extraction and tagging
Parses markdown skill files to extract structured metadata (title, description, tags, language, difficulty, category) from frontmatter (YAML/TOML) or markdown conventions (heading levels, code fence language tags). Metadata is indexed alongside skill content, enabling filtered searches (e.g., 'find all Python skills tagged with async'). Supports custom metadata fields through configuration.
Unique: Extracts metadata from markdown structure (YAML frontmatter, code fence language tags, heading levels) rather than requiring a separate metadata file, keeping skills self-contained and editable in any text editor
vs alternatives: More portable than database-based metadata (Notion, Obsidian) because metadata lives in the markdown file itself and is version-controllable
+3 more capabilities