How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/blutui/context --skill blutui-project-guidelinesBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Blutui Project Guidelines
Load the rule files that match your task. Always load ALL that apply — multiple rules often overlap.
Rule Index
| Task | Load |
|---|---|
| Creating/editing any template, layout, or component | rules/foundation-templates-and-layouts.md |
| Writing Canvas template syntax (tags, filters, functions) | rules/templating-canvas.md |
| Including/embedding other templates | rules/templating-including-templates.md |
| Working with Collections (querying, displaying data) | rules/collections.md |
| Building a blog listing or post page | rules/blog.md |
| Building or processing forms | rules/forms.md |
| Building site navigation (header, footer, dropdowns) | rules/menus.md |
| Setting up routing or URL patterns | rules/route-patterns.md |
| Configuring Courier | rules/courier.md, rules/foundation-courier-configuration.md |
| Project file structure / starting a new project | rules/foundation-file-structure.md |
| Version control / switching cassettes | rules/cassettes.md |
| Calling the Blutui MCP or writing MCP integrations | rules/mcp.md |
| Using Canopy Blocks (in-page editor) | rules/canopy.md + the blutui-canopy-blocks skill |
Rule files live at: rules/<rule-name>.md
Core Rules (Always Apply)
- Templates are the HTML shell; layouts are page types editors choose. Templates (
views/templates/) define the outer structure that wraps every page — developers own them, editors never touch them. Layouts (views/layouts/) extend templates and represent individual page designs that editors pick when creating pages in the dashboard. Seerules/foundation-templates-and-layouts.md. - Use Canvas for all templating logic. See
rules/templating-canvas.md. - Store structured content in Collections, not hardcoded in templates. See
rules/collections.md. - Never build raw HTML forms — use Blutui's form tags. See
rules/forms.md. - Don't invent new top-level directories. See
rules/foundation-file-structure.md. - Search documentation first. Use
search_blutui_documentationvia Blutui MCP before making code changes. Seerules/mcp.md.
Full Reference
For all rules in one document: AGENTS.md
Use AGENTS.md when you need a comprehensive reference or are unsure which rules apply.