moai-adk 0.8.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-lang-r/SKILL.md

@@ -1,123 +1,181 @@
 ---
-name: moai-lang-r
-version: 2.0.0
-created: 2025-10-22
-updated: 2025-10-22
-status: active
-description: R 4.4+ best practices with testthat 3.2, lintr 3.2, and data analysis patterns.
-keywords: ['r', 'testthat', 'lintr', 'data-analysis']
+name: "moai-lang-r"
+description: "R 4.4+ development specialist covering tidyverse, ggplot2, Shiny, and data science patterns. Use when developing data analysis pipelines, visualizations, or Shiny applications."
+version: 1.1.0
+category: "language"
+modularized: true
+user-invocable: false
+tags:
+  ["language", "r", "tidyverse", "ggplot2", "shiny", "dplyr", "data-science"]
+updated: 2026-01-11
+status: "active"
 allowed-tools:
   - Read
+  - Grep
+  - Glob
   - Bash
+  - mcp__context7__resolve-library-id
+  - mcp__context7__get-library-docs
 ---
 
-# Lang R Skill
+## Quick Reference (30 seconds)
 
-## Skill Metadata
+R 4.4+ Development Specialist - tidyverse, ggplot2, Shiny, renv, and modern R patterns.
 
-| Field | Value |
-| ----- | ----- |
-| **Skill Name** | moai-lang-r |
-| **Version** | 2.0.0 (2025-10-22) |
-| **Allowed tools** | Read (read_file), Bash (terminal) |
-| **Auto-load** | On demand when keywords detected |
-| **Tier** | Language |
+Auto-Triggers: Files with .R extension, .Rmd, .qmd, DESCRIPTION, renv.lock, Shiny or ggplot2 discussions
 
----
+Core Capabilities:
 
-## What It Does
+- R 4.4 Features: Native pipe operator, lambda syntax with backslash, improved error messages
+- Data Manipulation: dplyr, tidyr, purrr, stringr, forcats
+- Visualization: ggplot2, plotly, scales, patchwork
+- Web Applications: Shiny, reactivity, modules, bslib
+- Testing: testthat 3.0, snapshot testing, mocking
+- Package Management: renv, pak, DESCRIPTION
+- Reproducible Reports: R Markdown, Quarto
+- Database: DBI, dbplyr, pool
 
-R 4.4+ best practices with testthat 3.2, lintr 3.2, and data analysis patterns.
+### Quick Patterns
 
-**Key capabilities**:
-- ✅ Best practices enforcement for language domain
-- ✅ TRUST 5 principles integration
-- ✅ Latest tool versions (2025-10-22)
-- ✅ TDD workflow support
+dplyr Data Pipeline Pattern:
 
----
+Load tidyverse library. Create result by piping data through filter for year 2020 or later, mutate adding revenue_k as revenue divided by 1000 and growth as current minus lagged revenue divided by lagged revenue, group_by category, then summarise with total_revenue as sum, avg_growth as mean with na.rm TRUE, and groups set to drop.
+
+ggplot2 Visualization Pattern:
 
-## When to Use
+Load ggplot2 library. Create ggplot with data and aes mapping x to date, y to value, and color to category. Add geom_line with linewidth 1 and geom_point with size 2. Apply scale_color_viridis_d for color scale. Add labs for title, axis labels, and color legend. Apply theme_minimal for clean appearance.
 
-**Automatic triggers**:
-- Related code discussions and file patterns
-- SPEC implementation (`/alfred:2-run`)
-- Code review requests
+Shiny Basic App Pattern:
 
-**Manual invocation**:
-- Review code for TRUST 5 compliance
-- Design new features
-- Troubleshoot issues
+Load shiny library. Create ui using fluidPage with selectInput for variable selection from mtcars column names and plotOutput for plot. Create server function with input, output, and session parameters. In server, assign renderPlot to output plot using ggplot with mtcars and aes using .data pronoun with input variable for histogram. Create app with shinyApp passing ui and server.
 
 ---
 
-## Tool Version Matrix (2025-10-22)
+## Implementation Guide (5 minutes)
 
-| Tool | Version | Purpose | Status |
-|------|---------|---------|--------|
-| **R** | 4.4.2 | Primary | ✅ Current |
-| **testthat** | 3.2.2 | Primary | ✅ Current |
-| **lintr** | 3.2.0 | Primary | ✅ Current |
+### R 4.4 Modern Features
 
----
+Native Pipe Operator:
+
+Create result by piping data through filter removing NA values, mutate adding log_value as log of value, and summarise computing mean_log. For non-first argument position, use underscore placeholder in lm formula call with data parameter.
+
+Lambda Syntax with Backslash:
+
+Use map with data and backslash x syntax for x squared. Use map2 with two lists and backslash x y for x plus y. In dplyr contexts, use mutate with across on numeric columns applying backslash x for scale function extracting first column.
+
+### tidyverse Data Manipulation
+
+dplyr Core Verbs:
+
+Load dplyr library. Create processed by piping raw_data through filter for active status and positive amount, select for specific columns, mutate adding month using floor_date and amount_scaled dividing by max, then arrange descending by date. For grouped summaries, pipe through group_by, summarise with n for count, sum and mean for aggregations, and groups drop.
+
+tidyr Reshaping Pattern:
+
+Load tidyr library. For wide to long transformation, use pivot_longer with cols starting with year prefix, names_to for column name, names_prefix to strip, and values_to for values. For long to wide transformation, use pivot_wider with names_from and values_from, adding values_fill for missing value handling.
+
+purrr Functional Programming:
+
+Load purrr library. Use map with files and lambda to read_csv each file. Use map_dfr for row-binding with id parameter for source column. Use map_dbl for extracting numeric results with mean and na.rm TRUE. For error handling, create safe_read using safely wrapper on read_csv. Map files through safe_read, extract results, and use compact to filter successes.
+
+### ggplot2 Visualization Patterns
+
+Complete Plot Structure:
+
+Load ggplot2 and scales libraries. Create p using ggplot with data and aesthetics for x, y, and color by group. Add geom_point with alpha and size, geom_smooth with lm method and standard error. Apply scale_x_continuous with comma labels, scale_y_log10 with dollar labels, and scale_color_brewer with Set2 palette. Add facet_wrap by category with free_y scales. Add labs for title, subtitle, and axis labels. Apply theme_minimal with base_size and theme for legend position. Save with ggsave specifying filename, plot, dimensions, and dpi.
+
+Multiple Plots with patchwork:
+
+Load patchwork library. Create p1 with histogram, p2 with scatter plot, and p3 with boxplot. Combine using pipe and parentheses for layout with p1 beside p2 over p3. Add plot_annotation for title and tag_levels.
 
-## Inputs
+### Shiny Application Patterns
 
-- Language-specific source directories
-- Configuration files
-- Test suites and sample data
+Modular Shiny App:
 
-## Outputs
+Create dataFilterUI function taking id parameter. Use NS function for namespace. Return tagList with selectInput for category with NULL initial choices and sliderInput for range. Create dataFilterServer function taking id and data reactive. Use moduleServer with inner function. In observe block, extract unique categories and updateSelectInput. Return reactive filtering data by category and range inputs using req for input validation.
 
-- Test/lint execution plan
-- TRUST 5 review checkpoints
-- Migration guidance
+Reactive Patterns:
 
-## Failure Modes
+In server function, create processed_data as reactive caching filtered data by input year. Create counter as reactiveVal initialized to 0. Use observeEvent on input increment to update counter. Create analysis as eventReactive on input run_analysis for expensive computation. Apply debounce with 300 milliseconds on search input reactive for rapid input handling.
 
-- When required tools are not installed
-- When dependencies are missing
-- When test coverage falls below 85%
+### testthat Testing Framework
 
-## Dependencies
+Test Structure Pattern:
 
-- Access to project files via Read/Bash tools
-- Integration with `moai-foundation-langs` for language detection
-- Integration with `moai-foundation-trust` for quality gates
+Load testthat library. Create test_that block for calculate_growth with tibble of years and values. Call function and store result. Use expect_equal for row count, expect_equal for growth value with tolerance, and expect_true for NA check.
+
+### renv Dependency Management
+
+Project Setup:
+
+Call renv::init for initialization. Call renv::install for tidyverse and shiny packages. Call renv::snapshot to record state. Call renv::restore to restore from lockfile.
 
 ---
 
-## References (Latest Documentation)
+## Advanced Implementation (10+ minutes)
+
+For comprehensive coverage including:
+
+- Advanced Shiny patterns for async, caching, and deployment
+- Complex ggplot2 extensions and custom themes
+- Database integration with dbplyr and pool
+- R package development patterns
+- Performance optimization techniques
+- Production deployment with Docker and Posit Connect
 
-_Documentation links updated 2025-10-22_
+See:
+
+- modules/advanced-patterns.md for complete advanced patterns guide
 
 ---
 
-## Changelog
+## Context7 Library Mappings
 
-- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
-- **v1.0.0** (2025-03-29): Initial Skill release
+- tidyverse/dplyr for data manipulation verbs
+- tidyverse/ggplot2 for grammar of graphics visualization
+- tidyverse/purrr for functional programming toolkit
+- tidyverse/tidyr for data tidying functions
+- rstudio/shiny for web application framework
+- r-lib/testthat for unit testing framework
+- rstudio/renv for dependency management
 
 ---
 
 ## Works Well With
 
-- `moai-foundation-trust` (quality gates)
-- `moai-alfred-code-reviewer` (code review)
-- `moai-essentials-debug` (debugging support)
+- moai-lang-python for Python and R interoperability with reticulate
+- moai-domain-database for SQL patterns and database optimization
+- moai-workflow-testing for TDD and testing strategies
+- moai-essentials-debug for AI-powered debugging
+- moai-foundation-quality for TRUST 5 quality principles
 
 ---
 
-## Best Practices
+## Troubleshooting
+
+Common Issues:
+
+R Version Check:
+
+Call R.version.string in R console for version 4.4 or later. Call packageVersion with package name to check installed package versions.
 
-✅ **DO**:
-- Follow language best practices
-- Use latest stable tool versions
-- Maintain test coverage ≥85%
-- Document all public APIs
+Native Pipe Not Working:
+
+- Ensure R version is 4.1 or later for native pipe operator
+- Check RStudio settings under Tools, Global Options, Code for Use native pipe option
+
+renv Issues:
+
+Call renv::clean to remove unused packages. Call renv::rebuild to rebuild package library. Call renv::snapshot with force TRUE to force snapshot update.
+
+Shiny Reactivity Debug:
+
+Set options shiny.reactlog to TRUE. Call reactlog::reactlog_enable to enable logging. Call shiny::reactlogShow to display reactive log visualization.
+
+ggplot2 Font Issues:
+
+Load showtext library. Call font_add_google with font name and family. Call showtext_auto to enable for all graphics devices.
+
+---
 
-❌ **DON'T**:
-- Skip quality gates
-- Use deprecated tools
-- Ignore security warnings
-- Mix testing frameworks
+Last Updated: 2026-01-11
+Status: Active (v1.1.0)