Our review
First-level guide for starting work on a Plutonium application, listing generators, resource architecture, and best practices.
Strengths
- Provides a clear overview of the layered architecture (model, definition, policy, controller)
- Offers ready-to-use generators for creating resources, packages, and portals
- Directly references specialized skills to dive deeper into each concept
Limitations
- Does not detail advanced field or action configuration
- Assumes the user already knows Ruby on Rails and basic Plutonium concepts
- Does not cover error resolution or edge cases
When starting a new Plutonium application or needing a quick reminder on generators and architecture.
When implementing specific features like complex filters or detailed authorization – use the dedicated skill instead.
Security analysis
SafeThis skill provides high-level development guidelines for Plutonium applications. It includes examples of 'rails generate' commands (scaffold, connect, package, portal) with safe options. No destructive, exfiltrating, or obfuscated actions are present.
No concerns found
Examples
I need to create a Post resource with a title field in the main_app. Use the plutonium generator and connect it to the admin portal.Create a new Plutonium package called 'blogging' with a generator and then add a portal for it.Explain the layered architecture of a Plutonium resource (model, definition, policy, controller) and when to customize each layer.name: plutonium description: High-level guide for working with Plutonium applications - read this first
Plutonium Development Guide
Read this first when working on a Plutonium application.
Core Rules
- Always use generators - Never manually create resources, packages, or portals
- Check relevant skills first - Each concept has a dedicated skill with details
- Definitions over controllers - UI customization belongs in definitions, not controllers
- Policies for authorization - All permission logic goes in policies
Key Generators
rails g pu:res:scaffold Post title:string --dest=main_app # Create resource
rails g pu:res:conn Post --dest=admin_portal # Connect to portal
rails g pu:pkg:package blogging # Create feature package
rails g pu:pkg:portal admin_portal # Create portal
Always specify --dest to avoid interactive prompts.
Resource Architecture
A resource has four layers:
| Layer | Purpose | Customize when... | |-------|---------|-------------------| | Model | Data, validations, associations | Adding business logic | | Definition | UI - fields, actions, filters | Changing how things look/behave | | Policy | Authorization - who can do what | Restricting access | | Controller | Request handling | Rarely - use hooks if needed |
Skill Reference
| Topic | Skill |
|-------|-------|
| Creating resources | plutonium-create-resource |
| Connecting to portals | plutonium-connect-resource |
| Field configuration | plutonium-definition-fields |
| Actions & interactions | plutonium-definition-actions |
| Search, filters, scopes | plutonium-definition-query |
| Authorization | plutonium-policy |
| Custom views | plutonium-views |
| Custom forms | plutonium-forms |
| Nested resources | plutonium-nested-resources |
| Packages & portals | plutonium-package, plutonium-portal |
| Authentication | plutonium-rodauth |
Next.js App Router Expert
Development
A skill that turns Claude into a Next.js App Router expert.
README Generator
Development
Creates professional and comprehensive README.md files for your projects.
API Documentation Writer
Development
Generates comprehensive API documentation in OpenAPI/Swagger format.