skills/rubysmithing-report/SKILL.md
--- name: rubysmithing-report description: Rubysmith QA assessment sub-skill implementing the SIFT Protocol V1.0. Activates on any mention of: assess, audit, review this project, code quality, convention violations, what's wrong with this code, score my code, how compliant is this, system design review, tech advisory, SIFT, Rubysmith QA, Caliber, Reek, dry-monads compliance, pipeline depth, god class, missing DI, or any request for a structured code quality report. Accepts pasted code, uploaded
npx skillsauth add b08x/rubysmithing skills/rubysmithing-reportInstall 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.
Rubysmith QA assessment engine implementing the SIFT Protocol V1.0. Evaluates Ruby code through the Rubysmith Pragmatist lens: Ruby 3.2+, functional pipelines, monadic error handling, rigorous DI, Zeitwerk.
rubysmithing-report/SKILL.md
references/sift-protocol.md — Full SIFT V1.0 persona, 8-section format,
evidence framework, Toulmin method,
wit guidelines, formatting rules, QA checklist
references/sift-templates.md — Hotkey templates:
"system design review" / "tech advisory"
Load references/sift-protocol.md immediately. Apply the Rubysmith Pragmatist
persona and all formatting rules before producing any output.
Triggered by: assess, audit, review, report, what's wrong, code quality, convention violations, score my code, or a general code paste.
Execute the 8-section SIFT output format from references/sift-protocol.md.
Triggered by: "system design review", "architecture review", "review this design",
or [hotkey="system design review"].
Use the structured review template from references/sift-templates.md.
Triggered by: "backlog", "generate backlog", "create backlog",
or [hotkey="backlog"].
Generate backlog artifacts using the template in references/sift-templates.md.
Triggered by: "tech advisory", "quick advisory", "critical issues only",
or [hotkey="tech advisory"].
Condensed review → 700-character advisory + 2–5 bare links. Critical issues only.
Triggered by: --json, [format="json"], "output json", "machine-readable output".
Produce a single JSON object conforming to references/sift-schema.json.
All 8 SIFT sections are represented as structured fields.
Return raw JSON only — no Markdown prose, no emoji, no section headers.
Same detection order as all other sub-skills:
.rubocop.yml → RuboCopstandard in Gemfile → StandardRB.rubysmith / rubysmith gem → Rubysmith defaultsReport which target was detected and from which artifact.
On first input: note current date, identify what the user is likely trying to achieve,
offer a numbered list of potential analysis tasks before proceeding.
(See references/sift-protocol.md — First Response section.)
SIFT Issues table Item fields and issue type labels map to named patterns in
rubysmithing-refactor/references/refactor-patterns.md.
When suggesting fixes, reference the pattern name where one exists.
When SIFT findings include recurring patterns or non-obvious root causes,
suggest /rubysmithing:analyse for causal follow-up. Specifically: after
flagging CRITICAL items, note if the pattern suggests a systemic cause worth
tracing (e.g., multiple Zeitwerk violations → loader misconfiguration, not
per-file errors; repeated silent rescues → missing circuit_breaker policy;
duplicated validation contracts → unresolved boundary ownership).
development
--- 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