AI agents

Using Goshtoso With AI Agents

Goshtoso ships an installable agent skill for AI coding tools. The first version is focused on consumer apps: installing the library, serving bundled assets, wiring templ layouts, importing components, and avoiding common integration mistakes.

Install the Skill

Use the open npx skills CLI to install only the Goshtoso consumer-integration skill from the public repository.

bash

# Install into the current project/agent
npx skills add araihu/goshtoso --skill using-goshtoso

# Codex-specific install
npx skills add araihu/goshtoso --skill using-goshtoso --agent codex

# Global Codex install
npx skills add araihu/goshtoso --skill using-goshtoso --agent codex -g

Use Without Installing

For one-off prompts, stream the skill instructions directly into a supported agent instead of copying files into the project.

bash

npx skills use araihu/goshtoso --skill using-goshtoso

What the Skill Teaches

Install Goshtoso

Add the Go module and templ toolchain without generating code inside the Goshtoso dependency.

Serve assets

Mount assets.Handler() directly at /assets/ and avoid the double StripPrefix 404 trap.

Wire the page head

Use head.Dependencies() so CSS, Alpine.js, HTMX, and component scripts stay in sync.

Render components

Import component packages, use typed Config values, and consult the generated component reference.

Choose CSS strategy

Prefer the embedded stylesheet, or extract theme/source paths only for custom Tailwind builds.

Debug common misses

Check missing styles, combobox keyboard behavior, Alpine plugin order, and HTML-fragment HTMX handlers.

Scope

This skill is for consumer agents.

It does not teach agents how to maintain Goshtoso itself, edit component internals, run the release process, or operate an MCP server. Those workflows are intentionally separate so consumer agents get a compact, trustworthy integration guide.

Verify Distribution

Release maintainers can verify that the public skill remains discoverable and that supporting reference files are downloaded with it.

bash

npx --yes skills add araihu/goshtoso --list
npx --yes skills use araihu/goshtoso --skill using-goshtoso