skills/rubysmithing-genai/SKILL.md
--- name: rubysmithing-genai description: AI/NLP component scaffolder and advisor for Ruby projects. Activates on any mention of: LLM chat, chatbot, agent, tool-calling, function calling, RubyLLM::Agent, RubyLLM::Tool, streaming, RAG, retrieval augmented generation, vector search, semantic search, embedding, pgvector, DSPy, reasoning module, chain of thought, ReAct, MCP server, MCP tool, model context protocol, ruby_llm, RubyLLM, NLP, entity extraction, named entity recognition, sentence segment
npx skillsauth add b08x/rubysmithing skills/rubysmithing-genaiInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Scaffolder and advisor for AI/NLP components in the Ruby terminal-native stack. Generates single focused implementation files or explains integration patterns.
Before generating any implementation code:
Activate rubysmithing-context for every gem involved in this task.
This is not optional — generate no library-specific code until API syntax is confirmed
or a [WARNING: Unverified API Syntax] block has been injected.
Identify architectural plane: reasoning, retrieval, NLP, or transport?
Confirm async context: will this run inside an Async block?
If yes → non-blocking patterns required.
Confirm circuit breaker requirement: applies to all external LLM API calls in Standard Mode. Omit in Lite Mode (task ≤ ~50 lines).
Scaffolding — triggered by: create, build, implement, generate, scaffold, write me a. Output: single focused file, Zeitwerk-compliant path, complete implementation.
Advisory — triggered by: how do I, explain, what's the best way, compare, should I use. Output: recommendation + minimal snippet. No full file unless asked.
Compound prompts (e.g., "refactor this RAG pipeline AND build a TUI for it"): Split the request. Handle the GenAI component here. State explicitly: "Handling the RAG pipeline component. The TUI dashboard component should be addressed with rubysmithing-tui."
Load references/genai-patterns.md for implementation patterns:
RubyLLM::Agent configuration, RubyLLM::Tool class definitions, chatbot,
RAG ingestion/retrieval/full pipeline, DSPy modules, MCP server,
embedding generator (remote vs local), NLP processor, async+circuit breaker wrapper.
Generate RSpec specs only when explicitly requested:
spec/[path_matching_lib_file]_spec.rbdevelopment
--- name: rubysmithing description: Convention-aware Ruby code generator for the terminal-native AI orchestration stack (dotenv, tty-config, zeitwerk, async, dry-schema, sequel, journald-logger, circuit_breaker, parallel, concurrent-ruby). Use for generating Ruby classes, modules, Rake tasks, config wiring, boot layer code, data pipelines, POROs, error class hierarchies, parallel processing workers, content parsers, and Gemfile decisions. Applies project-detected conventions (RuboCop, StandardRB
development
YARD documentation generator with semantic analysis for Ruby files. Automatically activates on requests to generate, add, or improve YARD documentation. Uses AST parsing and type inference to generate comprehensive @param, @return, @example, and @raise tags. Maintains consistency with existing project documentation patterns and YARD configuration. Generates production-grade documentation that eliminates usage pitfalls and accelerates correct method implementation. Requires rubysmithing-context when the target file uses non-stdlib gems, to ensure type annotations reflect verified API shapes.
data-ai
--- name: rubysmithing-tui description: Terminal UI scaffolder and advisor for Ruby projects using the Charm/Bubble ecosystem. Activates on any mention of: TUI, terminal UI, terminal interface, terminal app, BubbleTea, bubbletea, Lipgloss, lipgloss, Bubbles, bubbles (UI components), Huh, huh form, form validation, Gum, gum prompts, NTCharts, charts, data visualization, Bubblezone, Glamour, glamour rendering, markdown display, Harmonica, harmonica animations, spring physics, smooth transitions, a
tools
--- name: rubysmithing-scaffold description: Ruby project scaffolder using rubysmith (apps, tools, scripts) or gemsmith (publishable gems). Activates on any mention of: scaffold a project, scaffold a gem, new ruby project, new gem, create gem, bootstrap project, rubysmith, gemsmith, generate project skeleton, project template, set up a new ruby app, start a ruby tool, start a ruby script, create a new gem for rubygems, initialize ruby project, rubysmith build, gemsmith build, new ruby