golem-agent-skills

Shared {golem} skills packaged for Claude Code and OpenAI agents.

Canonical skill content lives in skills/.

Made by ThinkR for professional Shiny development.

Overview

This repository provides:

• Claude Code and AGENTS plugin packaging around shared golem skills
• Best practice guidelines for Shiny app development
• Task-focused golem skills for common app workflows
• Complete documentation for installation and development workflows

What This Plugin Provides

A set of skills and guidelines for creating production-ready Shiny applications following R package best practices and golem conventions.

Skills

• Golem Create Golem - Create a new golem application
• Golem Add Module - Add a new module to an existing golem app
• Golem Add Function - Add business logic and utility functions
• Golem Check App - Run package checks and address common issues
• Golem Run Tests - Run and structure golem app tests
• Golem Upgrade - Upgrade golem apps across package and structure changes
• Golem Fix Missing ns - Check modules for missing ns()

Key Features

• Enforces R package best practices
• Golem naming conventions and patterns
• Reactive programming guidelines
• Module and function templates
• Test-driven development support
• Complete documentation and examples

Development Workflow

Create App -> Add Modules -> Add Functions -> Test -> Check -> Deploy

Key Commands

Once you have a golem app:

# Launch the app
Rscript -e "golem::run_dev()"

# Run tests
Rscript -e "devtools::test()"

# Check package
Rscript -e "devtools::check()"

# Regenerate documentation
Rscript -e "devtools::document()"

# Format code
air format .

File Naming Conventions

Type	Pattern	Example
Modules	R/mod_<name>.R	R/mod_gpx_reader.R
Module functions	R/mod_<name>_fct_<fn>.R	R/mod_gpx_reader_fct_parse.R
Module utilities	R/mod_<name>_utils_<fn>.R	R/mod_gpx_reader_utils_validate.R
Factory functions	R/fct_<name>.R	R/fct_similarity_calc.R
Utilities	R/utils_<name>.R	R/utils_formats.R
Tests	Mirror R/	tests/testthat/test-mod_gpx_reader.R

Requirements

• R 4.0+
• {golem} package
• {devtools} package
• {shiny} package

Claude Code installation

1. Add the marketplace from GitHub:

   /plugin marketplace add ThinkR-open/golem-agent-skills
   

2. Confirm the marketplace is available:

   /plugin marketplace list
   

3. Install the plugin:

   /plugin install golem-skills@golem-agent-skills
   

4. Reload plugins if prompted:

   /reload-plugins
   

5. After installation, the following plugin skills should be available:

   /golem-skills:golem-create-golem
   /golem-skills:golem-add-module
   /golem-skills:golem-add-function
   /golem-skills:golem-check-app
   /golem-skills:golem-run-tests
   /golem-skills:golem-upgrade
   /golem-skills:golem-fix-missing-ns
   /golem-skills:golem-fix-missing-ns-colin
   

   In current Claude Code versions, /golem-upgrade may also work directly, but the namespaced form above is the documented syntax.

Remove the plugin

/plugin uninstall golem-skills@golem-agent-skills
/plugin marketplace remove golem-agent-skills
/reload-plugins

{golem} package helper

The golem::use_agent_skills() (starting with version 0.6.0) helper can also install the same skill payloads into a {golem} project. It reads from the canonical upstream skills/ tree and copies into provider-specific target directories in the consuming Shiny App project:

• Claude target: .claude/skills/
• AGENTS target: .agents/skills/

This keeps the upstream repository canonical while preserving the expected project layout for each tool.

Contributors

This repository includes contributions from ThinkR and Ilya Zarubin.