alex-de-haas/docker-host

hosty-app-skill

Build, wrap, or update Hosty runtime apps.

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/alex-de-haas/docker-host --skill hosty-app-skill

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

Hosty App Skill

Use this skill to implement Hosty runtime apps in the shape expected by this repository. The supported contract is an app manifest with schemaVersion: "app.0.1".

Workflow

  1. Identify whether the user wants to create a new runtime app, wrap an existing app, update an app manifest, add Hosty identity/roles, configure data/backups, or validate an app.
  2. Treat docs/features/runtime-app-manifest/feature.md, docs/features/domain-model/feature.md, docs/features/auth-gateway/feature.md, apps/core/src/Haas.Hosty.Core/RuntimeAppManifest.cs, apps/core/src/Haas.Hosty.Core/CoreLifecycleService.cs, and apps/demo-app as source of truth when implementation details matter.
  3. Use apps/demo-app/manifest.json as the manifest shape and hosty apps install apps/demo-app --runtime dev as the local directory install pattern.

References

  • Read references/app-manifest.md when authoring or reviewing manifest.json, runtime profiles, service implementations, settings, storage, dependencies, endpoints, install/update behavior, or backups.
  • Read references/app-auth-and-users.md when adding app identity, app-owned roles, or scoped app directory access.
  • Read references/app-manifest.md ("MCP Interface") when adding or debugging an app's MCP endpoint — delegated- and scoped-token auth, the handshake's HTTP 202, and read-only annotations.
  • Read references/app-feeds.md when publishing or reviewing repository-owned feeds.json for Marketplace discovery and Core-managed updates.
  • Read references/app-launch-mode.md when the app has a UI, to keep it from drawing the name and page navigation a shell already renders around it.
  • Read references/demo-app-patterns.md when validating against the repository Demo App.
  • Read references/app-implementation-checklist.md before final verification.

Local Validation

Use Core-managed runtime app lifecycle:

bash
hosty core start
hosty apps install apps/demo-app --runtime dev
hosty apps start com.haas.demo-app

For direct endpoint probes:

bash
TOKEN="$(hosty apps identity com.haas.demo-app --user user@docker-host.local --format token)"
curl -H "X-Docker-Host-Identity: $TOKEN" <assigned-demo-app-origin>/api/auth/identity

Verwandte Aufgaben