Skip to contents

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

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.