使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/blutui/context --skill blutui-project-guidelines开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
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.