skill-creation
Skill Creation Guide
Generate properly formatted SKILL.md files that help AI agents perform domain-specific tasks effectively.
File Structure
Every skill must have:
- YAML frontmatter with required fields
- Markdown body with clear instructions
- Progressive disclosure (concise main file, detailed references separate)
Optional directories:
scripts/: Executable code agents can run. Keep scripts self-contained or document dependencies, and include clear error handling.references/: On-demand documentation (for example,REFERENCE.md, templates, domain notes). Keep files focused and small for efficient context usage.assets/: Static resources such as templates, diagrams, and data files.
Recommended layout:
More from rolemodel/rolemodel-skills
bem-structure
Expert guidance for writing, refactoring, and structuring CSS using BEM (Block Element Modifier) methodology. Provides proper CSS class naming conventions, component structure, and Optics design system integration for maintainable, scalable stylesheets.
85optics-context
Use the Optics design framework for styling applications. Apply Optics classes for layout, spacing, typography, colors, and components. Use when working on CSS, styling views, or implementing design system guidelines.
38routing-patterns
Review, generate, and update Rails routes following professional patterns and best practices. Covers RESTful resource routing, route concerns for code reusability, shallow nesting strategies, and advanced route configurations.
29turbo-fetch
Implement dynamic form updates using Turbo Streams and Stimulus. Use when forms need to update fields based on user selections without full page reloads, such as cascading dropdowns, conditional fields, or dynamic option lists.
27stimulus-controllers
Create and register Stimulus controllers for interactive JavaScript features. Use when adding client-side interactivity, dynamic UI updates, or when the user mentions Stimulus controllers or JavaScript behavior.
26controller-patterns
Review and update existing Rails controllers and generate new controllers following professional patterns and best practices. Covers RESTful conventions, authorization patterns, proper error handling, and maintainable code organization.
26