db-aeon/joshu-oss/templates

Name: templates
Author: db-aeon

Claude Code and agent skill by db-aeon/joshu-oss

Trust tier 3

community

Source check pending

Checking that the SKILL.md file is still in the repository.

<AppName> desktop UI — GUI-first agent rules when the app window is open.

Install

npx vskill@latest install db-aeon/joshu-oss/templates

SKILL.md

<AppName> GUI skill

Use when the <AppName> window is open (embedded chat or voice).

Replace <AppName>, <app-id>, guiAction names, and platform skill references before shipping.

Platform boundary (embedded — GUI first)

When this app is open, treat the on-screen list/detail as the source of truth for read/list questions.

User intent	Do this	Do NOT
List / summarize visible items, “what’s open?”	Read `listPreview` / `openDetail` from injected GUI snapshot	Platform MCP / `agent.usesSkills` tools
Snapshot empty or user says “refresh”	`app_gui_action` `refreshList` (return rows in tool result)	MCP first
Filter/search in current view	`app_gui_action` `searchList` (or equivalent), then snapshot	MCP first
Open item / open editor with draft	`app_gui_action` `openDetail` / `openEditor`	Chat-only paste
Data outside loaded GUI, deep search, other tenant, headless	`skill_view('<platform-skill>')` → MCP / invoke	—
Cron / automation / no UI	`POST /joshu/api/apps/<app-id>/invoke` + platform skills	—

Never auto-submit destructive actions (send, delete, pay, …) — user confirms in the UI.

GUI snapshot fields (implement in `getGuiSnapshot`)

`activeView`: list | detail | editor | setup (what the user sees)
`listPreview`: loaded rows in the sidebar/list — same data as on screen
`openDetail`: full record when one item is open
`editor`: only when activeView is editor (do not leak when viewing list/detail)

Embedded chat rules

UI changes → `app_gui_action(appId="<app-id>", action=…, args=…)`
After drafting content for the user to edit, open the editor via guiAction — do not only paste in chat.

Headless (no app window)

Follow platform skills in agent.usesSkills and invoke API actions in joshu.app.json.

guiActions reference

Declare in joshu.app.json agent.guiActions[] and register matching useJoshuGuiAction handlers:

action	Effect
`refreshList`	Reload visible list; return summary for agent
`searchList`	Filter list (`query` arg)
`openDetail`	Open item by id
`openEditor`	Open editor with optional draft fields
_(add app-specific actions)_

Voice fast path (optional)

Map manifest guiActions[].voice to the same handlers as useJoshuGuiAction (legacy voiceCommands[] still supported).

Security

Security scanPassed, 95 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingdocs/templates/my-app-gui-SKILL.md

Popularity

7-day trend score: 5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/db-aeon/joshu-oss/templates/badge)](https://verified-skill.com/skills/db-aeon/joshu-oss/templates)

Something wrong with this skill or its page? Tell us.