Arandu View Templates

What it does

When your agent uses it

• Adding a page or changing a layout in an Arandu application
• Building a form or rendering a list with the DataTable component
• Writing an HTMX fragment under resources/views
• Working out why an inline style or Alpine attribute is blocked

Example prompts

• “Add a page that lists projects with the DataTable component and a button to create one.”
• “Make an edit form for notes using Field, Textarea and Checkbox.”
• “My view shows a blank space where the title should be. Check the data struct and the escaping.”
• “Change the layout so the sidebar sits inside a new section.”

Requirements

• An Arandu (Go) project with the aru CLI

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1Write the .kyse.go, its data struct in @go
2. 2Decide page or fragment. Every navigation -- a direct visit, a link the
3. 3Answer it from the controller with the fragment only when ctx.IsHTMX()
4. 4Build, compile, check: aru view:build names the template's line,

What it can do on your machine

Read from SKILL.md and the folder at commit b8a4273. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • go
  • bash

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Arandu View Templates loads about 2.2k tokens when it runs. Until then it costs about 179 tokens; SKILL.md has 887 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~179

When it runs · the whole SKILL.md, loaded when a task matches

~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from arandu-io/arandu at commit b8a4273, republished under its MIT licence (© arandu-io). 887 words, ~2,236 tokens.

name

arandu-view

description

Write or change a page, layout, template, HTML fragment or component usage in an Arandu (Go) application -- anything under resources/views. Use when the request is to "add a page", "change the layout", "make a form", "render a list", "style this", "load this part with htmx", or when a fragment, hx-get, hx-target, @include or a partial is involved. The templates are .kyse.go files compiled to Go, and the syntax, the escaping rules and the Content-Security-Policy constraints are not the ones any other template engine uses. Covers @extends, @section, @foreach, the typed data struct, page against fragment, escaped versus raw interpolation, and why an inline style or an Alpine attribute will not work.

license

MIT

package example

import (
	"net/http"

	hhttp "github.com/arandu-io/hesape/http"
	"github.com/arandu-io/hesape/view"

	views "<module>/storage/framework/views/notes"
)

// Listing answers the page to every navigation, and the table alone to the
// one request that names the table as the element it replaces.
func Listing(ctx *hhttp.Context, rows []views.NoteRow) error {
	data := views.NotesIndexData{
		Page:   view.New(ctx, "Notes"),
		Notes:  rows,
		NewURL: ctx.URL("notes.create"),
	}
	ctx.Response.Header().Add("Vary", "HX-Request, HX-Target")
	if ctx.IsHTMX() && ctx.Header("HX-Target") == views.NotesTableID {
		return ctx.Fragment(http.StatusOK, "partials.notes_table", data)
	}
	return ctx.View("notes.index", data)
}

export GOWORK=off
aru model:build --check
aru view:build
gofmt -l $(find . -name '*.go' -not -path '*/testdata/*' -not -name '*.kyse.go')
go vet ./...
bash tests/test-layout-guard.sh
go test -race ./...
go build ./...
aru doctor

<!-- arandu:begin custom -->

<!-- arandu:end custom -->

© arandu-io, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/arandu-view of arandu-io/arandu.

Open the folder on GitHubat commit b8a4273