菜单
Rails and ActiveModel model conventions for Folio: validations, form-facing attributes, console required-marker inference, attachment/file placement validation targets, and model behavior that affects admin forms. Use when adding or changing model validations, virtual attributes, attachment validations, or console-administered model fields.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Folio and host-app testing conventions. Use when adding, changing, debugging, or reviewing tests, test helpers, factories/fixtures, mocks, stubs, ViewComponent tests, JavaScript behavior tests, integration/system coverage, or files under test/ and packs/*/test.
Folio “HTML over wire” JSON APIs: controllers use render_component_json so the response body is JSON with a string "data" key holding rendered ViewComponent HTML; JavaScript uses Folio.Api.apiGet/apiPost and response.data, not pure domain JSON for client-side rendering. Use when adding or changing render_component_json, console/API endpoints that return component fragments, or consumers of response.data as HTML.
JavaScript conventions for Folio: ES6+, StandardJS linting, DOM APIs, Folio.Api fetch wrappers, debounce/throttle, flash events, and when to use Stimulus. Use when writing or editing .js files, adding behavior to components, or when the user asks about JavaScript patterns in Folio.
Folio optional pack boundary and namespace rules. Use when editing files in optional pack directories, adding pack controllers/components/models/lib code, wiring routes to pack code, or moving reusable behavior between a host app, the Folio engine, and an optional pack, including Packwerk verification.
Build or change Folio SimpleForm inputs and extensions: app/inputs classes, SimpleForm::Inputs overrides, register_stimulus wiring, input_controls, custom_html, standalone input JS/Sass assets, and rendered HTML tests.
Slim template formatting and best practices for Folio components and views. Use when writing or editing .slim templates, reviewing Slim formatting, or when the user asks about Slim conventions, multi-line attributes, or template structure in Folio.
| name | folio-rails-models |
| description | Rails and ActiveModel model conventions for Folio: validations, form-facing attributes, console required-marker inference, attachment/file placement validation targets, and model behavior that affects admin forms. Use when adding or changing model validations, virtual attributes, attachment validations, or console-administered model fields. |
Use this skill when model validations or virtual attributes affect how records behave in Folio console forms.
validates :attribute, presence: true on the same attribute the form renders.required: explicitly.
Examples: validates :link, presence: true marks f.input :link;
validates :cover_placement, presence: true marks a picker label rendered
for cover_placement.file_picker_for_cover, the asterisk appears with
cover_placement, not cover, because the picker label is
@f.label @placement_key.required:, when the
console form label must show the required marker.folio_embed_data on assignment.nil
contract, and configure unsafe-HTML sanitization deliberately..skills/folio-embed-data/SKILL.md
for the canonical embed contract and implementation details..skills/folio-simple-form-inputs/SKILL.md
when changing SimpleForm input classes, wrappers, or generated input HTML..skills/folio-rails-code-structure/SKILL.md
when changing model method structure or extracting multi-step model logic.